conditional_access_named_locations

Creates, updates, deletes, gets or lists a conditional_access_named_locations resource.

Overview

Name	conditional_access_named_locations
Type	Resource
Id	entra_id.identity.conditional_access_named_locations

Fields

The following fields are returned by SELECT queries:

get

Retrieved navigation property

Name	Datatype	Description
id	string	Identifier of a namedLocation object. Read-only.
createdDateTime	string (date-time)	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. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)
deletedDateTime	string (date-time)	(pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)
displayName	string	Human-readable name of the location.
modifiedDateTime	string (date-time)	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. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)

list

Retrieved collection

Name	Datatype	Description
id	string	Identifier of a namedLocation object. Read-only.
createdDateTime	string (date-time)	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. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)
deletedDateTime	string (date-time)	(pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)
displayName	string	Human-readable name of the location.
modifiedDateTime	string (date-time)	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. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	named_location_id		Retrieve the properties and relationships of a countryNamedLocation object.
list	select			Get a list of namedLocation objects.
insert	insert			Create a new namedLocation object. Named locations can be either ipNamedLocation or countryNamedLocation objects.
update	update	named_location_id		Update the properties of a countryNamedLocation object.
delete	delete	named_location_id	If-Match	Delete a countryNamedLocation object.
restore	exec	named_location_id

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
named_location_id	string	The unique identifier of namedLocation
If-Match	string	ETag

SELECT examples

get

Retrieve the properties and relationships of a countryNamedLocation object.

SELECT
id,
createdDateTime,
deletedDateTime,
displayName,
modifiedDateTime
FROM entra_id.identity.conditional_access_named_locations
WHERE named_location_id = '{{ named_location_id }}' -- required
;

list

Get a list of namedLocation objects.

SELECT
id,
createdDateTime,
deletedDateTime,
displayName,
modifiedDateTime
FROM entra_id.identity.conditional_access_named_locations
;

INSERT examples

insert

Create a new namedLocation object. Named locations can be either ipNamedLocation or countryNamedLocation objects.

INSERT INTO entra_id.identity.conditional_access_named_locations (
deletedDateTime,
createdDateTime,
displayName,
id,
modifiedDateTime
)
SELECT 
'{{ deletedDateTime }}',
'{{ createdDateTime }}',
'{{ displayName }}',
'{{ id }}',
'{{ modifiedDateTime }}'
RETURNING
id,
createdDateTime,
deletedDateTime,
displayName,
modifiedDateTime
;

Manifest

# Description fields are for documentation purposes
- name: conditional_access_named_locations
props:
  - name: deletedDateTime
    value: "{{ deletedDateTime }}"
  - name: createdDateTime
    value: "{{ createdDateTime }}"
    description: |
      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.
  - name: displayName
    value: "{{ displayName }}"
    description: |
      Human-readable name of the location.
  - name: id
    value: "{{ id }}"
    description: |
      Identifier of a namedLocation object. Read-only.
  - name: modifiedDateTime
    value: "{{ modifiedDateTime }}"
    description: |
      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.

UPDATE examples

update

Update the properties of a countryNamedLocation object.

UPDATE entra_id.identity.conditional_access_named_locations
SET 
deletedDateTime = '{{ deletedDateTime }}',
createdDateTime = '{{ createdDateTime }}',
displayName = '{{ displayName }}',
id = '{{ id }}',
modifiedDateTime = '{{ modifiedDateTime }}'
WHERE 
named_location_id = '{{ named_location_id }}' --required
RETURNING
id,
createdDateTime,
deletedDateTime,
displayName,
modifiedDateTime;

DELETE examples

delete

Delete a countryNamedLocation object.

DELETE FROM entra_id.identity.conditional_access_named_locations
WHERE named_location_id = '{{ named_location_id }}' --required
AND If-Match = '{{ If-Match }}'
;

Lifecycle Methods

restore

Success

EXEC entra_id.identity.conditional_access_named_locations.restore 
@named_location_id='{{ named_location_id }}' --required
;