Edit

countryNamedLocation resource type

  • Article

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 countryNamedLocations countryNamedLocation collection Get all the countryNamedLocation objects in the organization.
Create countryNamedLocation countryNamedLocation Create a new countryNamedLocation object.
Get countryNamedLocation countryNamedLocation Read the properties and relationships of a countryNamedLocation object.
Update countryNamedLocation countryNamedLocation Update a countryNamedLocation object.
Delete countryNamedLocation 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 is a JSON representation of the resource.

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

Related content