countryNamedLocation resource type

Namespace: microsoft.graph

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.

Properties

Property Type Description
countriesAndRegions String collection List of countries and/or regions in two-letter format specified by ISO 3166-2. Required.
countryLookupMethod countryLookupMethodType Determines what method is used to decide which country the user is located in. Possible values are clientIpAddress(default) and authenticatorAppGps. Note: authenticatorAppGps is not yet supported in the Microsoft Cloud for US Government.
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.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "countriesAndRegions": ["String"],
  "countryLookupMethod": "String",
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "id": "String (identifier)",
  "includeUnknownCountriesAndRegions": true,
  "modifiedDateTime": "String (timestamp)"
}