Skip to content

countrynamedlocation.md

Latest commit

 

History

History
72 lines (61 loc) · 3.97 KB

countrynamedlocation.md

File metadata and controls

72 lines (61 loc) · 3.97 KB

title: "countryNamedLocation resource type" description: "Represents a Microsoft Entra ID named location defined by countries and regions. Named locations are custom rules that define network locations which can then be used in a Conditional Access policy." author: "ashyasingh" ms.date: 08/11/2025 ms.localizationpriority: medium ms.subservice: "entra-sign-in" doc_type: resourcePageType

countryNamedLocation resource type

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Represents a Microsoft Entra ID named location defined by countries and regions. Named locations are custom rules that define network locations which can then be used in a Conditional Access policy.

Inherits from namedLocation.

Methods

Method Return type Description
List countryNamedLocation collection Get all the countryNamedLocation objects in the organization.
Create countryNamedLocation Create a new countryNamedLocation object.
Get countryNamedLocation Read the properties and relationships of a countryNamedLocation object.
Update countryNamedLocation Update a countryNamedLocation object.
Delete None Delete a countryNamedLocation object.
Restore countryNamedLocation Restore a deleted countryNamedLocation object.

Properties

Property Type Description
countriesAndRegions String collection List of countries and/or regions in two-letter format specified by ISO 3166-2.
countryLookupMethod countryLookupMethodType Determines what method is used to decide which country the user is located in. Possible values are clientIpAddress (default) and authenticatorAppGps.
createdDateTime DateTimeOffset The Timestamp type represents creation date and time of the location using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Inherited from namedLocation.
displayName String Human-readable name of the location. Required. Inherited from namedLocation.
id String Identifier of a namedLocation object. Read-only. Inherited from namedLocation.
includeUnknownCountriesAndRegions Boolean true if IP addresses that don't map to a country or region should be included in the named location. Optional. Default value is false.
modifiedDateTime DateTimeOffset The Timestamp type represents last modified date and time of the location using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Inherited from namedLocation.
deletedDateTime DateTimeOffset Shows the last date and time the named location was deleted.Inherited from policyDeletableItem.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.countryNamedLocation",
  "deletedDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "displayName": "String",
  "createdDateTime": "String (timestamp)",
  "modifiedDateTime": "String (timestamp)",
  "countriesAndRegions": [
    "String"
  ],
  "includeUnknownCountriesAndRegions": "Boolean",
  "countryLookupMethod": "String"
}