Microsoft.InstanceMetadataService (stable:2018-02-01)

2025/10/23 • 3 deleted methods

Instances_GetMetadata (removed)
Description :  Get Instance Metadata for the Virtual Machine.
Reference :  Link ¶

⚼ Request

GET:  /instance
{
api-version:
{
Description: This is the API version to use. ,
Required: True ,
}
string ,
Metadata:
{
Description: This must be set to 'true'. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
compute:
{
Description: Compute Metadata ,
Required: False ,
}
{
location:
{
Description: This is the Azure Region in which the VM is running. ,
Required: False ,
}
string ,
name:
{
Description: This is the name of the VM. ,
Required: False ,
}
string ,
offer:
{
Description: This is the offer information for the VM image. This value is only present for images deployed from the Azure Image Gallery. ,
Required: False ,
}
string ,
osType:
{
Description: This value indicates the type of OS the VM is running, either Linux or Windows. ,
Required: False ,
}
string ,
placementGroupId:
{
Description: This is the placement group of your Virtual Machine Scale Set. ,
Required: False ,
}
string ,
platformFaultDomain:
{
Description: This is the fault domain in which the VM. ,
Required: False ,
}
string ,
platformUpdateDomain:
{
Description: This is the update domain in which the VM. ,
Required: False ,
}
string ,
publisher:
{
Description: This is the publisher of the VM image. ,
Required: False ,
}
string ,
resourceGroupName:
{
Description: This is the resource group for the VM. ,
Required: False ,
}
string ,
sku:
{
Description: This is the specific SKU for the VM image. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: This is the Azure subscription for the VM. ,
Required: False ,
}
string ,
tags:
{
Description: This is the list of tags for your VM. ,
Required: False ,
}
string ,
version:
{
Description: This is the version of the VM image. ,
Required: False ,
}
string ,
vmId:
{
Description: This is the unique identifier for the VM. ,
Required: False ,
}
string ,
vmScaleSetName:
{
Description: This is the resource name of the VMSS. ,
Required: False ,
}
string ,
vmSize:
{
Description: This is the size of the VM. ,
Required: False ,
}
string ,
zone:
{
Description: This is the availability zone of the VM. ,
Required: False ,
}
string ,
}
,
network:
{
Description: Network Metadata ,
Required: False ,
}
{
interface:
{
Description: This contains data about the network interface. ,
Required: False ,
}
[
{
ipv4:
{
Description: This contains the IPv4 address. ,
Required: False ,
}
{
ipAddress:
{
Description: This is the IP address ,
Required: False ,
}
[
{
privateIpAddress:
{
Description: This is the private IP address assigned to the interface. ,
Required: False ,
}
string ,
publicIpAddress:
{
Description: This is the public IP address assigned to the interface. ,
Required: False ,
}
string ,
}
,
]
,
subnet:
{
Description: This is the subnet ,
Required: False ,
}
[
{
address:
{
Description: This is the address range of the subnet. ,
Required: False ,
}
string ,
prefix:
{
Description: This is the prefix of the subnet. ,
Required: False ,
}
string ,
}
,
]
,
}
,
ipv6:
{
Description: This contains the IPv6 address. ,
Required: False ,
}
{
ipAddress:
{
Description: This is the IP address ,
Required: False ,
}
[
{
privateIpAddress:
{
Description: This is the private IPv6 address assigned to the interface. ,
Required: False ,
}
string ,
}
,
]
,
}
,
macAddress:
{
Description: This is the MAC address of the interface. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (400)

{
error:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (403)

{
error:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (404)

{
error:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (405)

{
error:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (429)

{
error:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (503)

{
error:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (500)

{
error:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
Identity_GetToken (removed)
Description :  Get a Token from Azure AD
Reference :  Link ¶

⚼ Request

GET:  /identity/oauth2/token
{
Metadata:
{
Description: This must be set to 'true'. ,
Required: True ,
}
string ,
resource:
{
Description: This is the urlencoded identifier URI of the sink resource for the requested Azure AD token. The resulting token contains the corresponding aud for this resource. ,
Required: True ,
}
string ,
api-version:
{
Description: This is the API version to use. ,
Required: True ,
}
string ,
client_id:
{
Description: This identifies, by Azure AD client id, a specific explicit identity to use when authenticating to Azure AD. Mutually exclusive with object_id and msi_res_id. ,
Required: False ,
}
string ,
object_id:
{
Description: This identifies, by Azure AD object id, a specific explicit identity to use when authenticating to Azure AD. Mutually exclusive with client_id and msi_res_id. ,
Required: False ,
}
string ,
msi_res_id:
{
Description: This identifies, by urlencoded ARM resource id, a specific explicit identity to use when authenticating to Azure AD. Mutually exclusive with client_id and object_id. ,
Required: False ,
}
string ,
authority:
{
Description: This indicates the authority to request AAD tokens from. Defaults to the known authority of the identity to be used. ,
Required: False ,
}
string ,
bypass_cache:
{
Description: If provided, the value must be 'true'. This indicates to the server that the token must be retrieved from Azure AD and cannot be retrieved from an internal cache. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
access_token:
{
Description: This is the requested access token. The app can use this token to authenticate to the sink resource. ,
Required: False ,
}
string ,
expires_in:
{
Description: This is how long the access token is valid (in seconds). ,
Required: False ,
}
string ,
expires_on:
{
Description: This is the time when the access token expires. The date is represented as the number of seconds from 1970-01-01T0:0:0Z UTC until the expiration time. This value is used to determine the lifetime of cached tokens. ,
Required: False ,
}
string ,
ext_expires_in:
{
Description: This indicates the extended lifetime of the token. ,
Required: False ,
}
string ,
not_before:
{
Description: This is the time when the access token becomes effective. The date is represented as the number of seconds from 1970-01-01T0:0:0Z UTC until the expiration time. ,
Required: False ,
}
string ,
resource:
{
Description: This is the app ID URI of the sink resource. ,
Required: False ,
}
string ,
token_type:
{
Description: This indicates the token type value. ,
Required: False ,
}
string ,
client_id:
{
Description: This is the client_id specified in the request, if any. ,
Required: False ,
}
string ,
object_id:
{
Description: This is the object_id specified in the request, if any. ,
Required: False ,
}
string ,
msi_res_id:
{
Description: This is the msi_res_id specified in the request, if any. ,
Required: False ,
}
string ,
}

⚐ Response (400)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (404)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (405)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (429)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (500)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
Identity_GetInfo (removed)
Description :  Get information about AAD Metadata
Reference :  Link ¶

⚼ Request

GET:  /identity/info
{
Metadata:
{
Description: This must be set to 'true'. ,
Required: True ,
}
string ,
api-version:
{
Description: This is the API version to use. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
tenantId:
{
Description: This is the AAD tenantId of the identity of the caller. ,
Required: False ,
}
string ,
}

⚐ Response (400)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (404)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (405)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (429)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (500)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: Error code ,
Enum:
{
invalid_request: No description available. ,
unauthorized_client: No description available. ,
access_denied: No description available. ,
unsupported_response_type: No description available. ,
invalid_scope: No description available. ,
server_error: No description available. ,
service_unavailable: No description available. ,
bad_request: No description available. ,
forbidden: No description available. ,
not_found: No description available. ,
method_not_allowed: No description available. ,
too_many_requests: No description available. ,
}
,
Required: False ,
}
enum ,
error_description:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
}