{ "swagger": "2.0", "info": { "version": "2020-03-01", "title": "azureactivedirectory", "description": "Azure Active Directory Client." }, "host": "management.azure.com", "schemes": [ "https" ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "security": [ { "azure_auth": [ "user_impersonation" ] } ], "securityDefinitions": { "azure_auth": { "type": "oauth2", "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", "flow": "implicit", "description": "Azure Active Directory OAuth2 Flow", "scopes": { "user_impersonation": "impersonate your user account" } } }, "paths": { "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.aadiam/privateLinkForAzureAd/{policyName}/privateEndpointConnections": { "get": { "tags": [ "PrivateEndpointConnections" ], "operationId": "PrivateEndpointConnections_ListByPolicyName", "x-ms-examples": { "AadiamListPrivateEndpointConnections": { "$ref": "./examples/AzureADPrivateEndpointConnectionsList.json" } }, "description": "Lists all Private Endpoint Connections for the given policy.", "parameters": [ { "$ref": "#/parameters/resourceGroupNameParameter" }, { "$ref": "#/parameters/policyNameParameter" }, { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" } ], "responses": { "200": { "description": "Private Endpoint Connections for given policy returned successfully", "schema": { "$ref": "#/definitions/PrivateEndpointConnectionListResult" } }, "default": { "description": "Aadiam error response describing why the operation failed.", "schema": { "$ref": "../../common/1.0/types.json#/definitions/ErrorResponse" } } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.aadiam/privateLinkForAzureAd/{policyName}/privateEndpointConnections/{privateEndpointConnectionName}": { "put": { "tags": [ "PrivateEndpointConnections" ], "operationId": "PrivateEndpointConnections_Create", "x-ms-examples": { "AadiamPutPrivateEndpointConnection": { "$ref": "./examples/AzureADPrivateEndpointConnectionsCreate.json" } }, "description": "Creates specified private endpoint connection associated with the given policy.", "parameters": [ { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" }, { "$ref": "#/parameters/resourceGroupNameParameter" }, { "$ref": "#/parameters/policyNameParameter" }, { "$ref": "#/parameters/privateEndpointConnectionName" }, { "name": "parameters", "in": "body", "required": true, "schema": { "$ref": "#/definitions/PrivateEndpointConnection" }, "description": "The intended state of private endpoint connection." } ], "responses": { "201": { "description": "The state of private endpoint connection was updated successfully.", "schema": { "$ref": "#/definitions/PrivateEndpointConnection" } }, "default": { "description": "Aadiam error response describing why the operation failed.", "schema": { "$ref": "../../common/1.0/types.json#/definitions/ErrorResponse" } } }, "x-ms-long-running-operation": true }, "delete": { "tags": [ "PrivateEndpointConnections" ], "operationId": "PrivateEndpointConnections_Delete", "x-ms-examples": { "AadiamDeletePrivateEndpointConnections": { "$ref": "./examples/AzureADPrivateEndpointConnectionsDelete.json" } }, "description": "Deletes the specified private endpoint connection associated with the given policy.", "parameters": [ { "$ref": "#/parameters/resourceGroupNameParameter" }, { "$ref": "#/parameters/policyNameParameter" }, { "$ref": "#/parameters/privateEndpointConnectionName" }, { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" } ], "responses": { "200": { "description": "The private endpoint connection does not exist." }, "202": { "description": "The private endpoint connection does not exist." }, "204": { "description": "The private endpoint connection does not exist." }, "default": { "description": "Aadiam error response describing why the operation failed.", "schema": { "$ref": "../../common/1.0/types.json#/definitions/ErrorResponse" } } }, "x-ms-long-running-operation": true }, "get": { "tags": [ "PrivateEndpointConnections" ], "operationId": "PrivateEndpointConnections_Get", "x-ms-examples": { "AadiamGetPrivateEndpointConnections": { "$ref": "./examples/AzureADPrivateEndpointConnectionsGet.json" } }, "description": "Gets the specified private endpoint connection associated with the given policy.", "parameters": [ { "$ref": "#/parameters/resourceGroupNameParameter" }, { "$ref": "#/parameters/policyNameParameter" }, { "$ref": "#/parameters/privateEndpointConnectionName" }, { "$ref": "#/parameters/apiVersionParameter" }, { "$ref": "#/parameters/subscriptionIdParameter" } ], "responses": { "200": { "description": "Private endpoint connection successfully returned.", "schema": { "$ref": "#/definitions/PrivateEndpointConnection" } }, "default": { "description": "Aadiam error response describing why the operation failed.", "schema": { "$ref": "../../common/1.0/types.json#/definitions/ErrorResponse" } } } } } }, "definitions": { "PrivateEndpointConnectionListResult": { "properties": { "value": { "type": "array", "description": "Array of private link resources", "items": { "$ref": "#/definitions/PrivateEndpointConnection" } }, "nextLink": { "description": "URL to next page of results", "type": "string" } }, "type": "object", "description": "A list of private link resources" }, "PrivateEndpointConnection": { "properties": { "properties": { "$ref": "#/definitions/PrivateEndpointConnectionProperties", "x-ms-client-flatten": true, "description": "Resource properties." } }, "allOf": [ { "$ref": "../../../../../../common-types/resource-management/v1/types.json#/definitions/ProxyResource" } ], "type": "object", "description": "Private endpoint connection resource.", "x-ms-azure-resource": true }, "PrivateEndpointConnectionProperties": { "properties": { "privateEndpoint": { "$ref": "#/definitions/PrivateEndpoint", "description": "Properties of the private endpoint object." }, "privateLinkServiceConnectionState": { "$ref": "#/definitions/PrivateLinkServiceConnectionState", "description": "Approval state of the private link connection." }, "provisioningState": { "$ref": "#/definitions/PrivateEndpointConnectionProvisioningState", "description": "Provisioning state of the private endpoint connection." }, "privateLinkConnectionTags": { "description": "Updated tag information to set into the PrivateLinkConnection instance.", "$ref": "#/definitions/TagsResource", "x-ms-mutability": [ "update" ] } }, "type": "object", "description": "Properties of the private endpoint connection resource." }, "PrivateEndpoint": { "properties": { "id": { "type": "string", "description": "Full identifier of the private endpoint resource." } }, "type": "object", "description": "Private endpoint object properties." }, "PrivateLinkServiceConnectionState": { "properties": { "status": { "$ref": "#/definitions/PrivateEndpointServiceConnectionStatus", "description": "Indicates whether the connection has been approved, rejected or removed by the given policy owner." }, "description": { "type": "string", "description": "The reason for approval or rejection." }, "actionsRequired": { "type": "string", "description": "A message indicating if changes on the service provider require any updates on the consumer." } }, "type": "object", "description": "An object that represents the approval state of the private link connection." }, "PrivateEndpointServiceConnectionStatus": { "type": "string", "description": "The private endpoint connection status.", "enum": [ "Approved", "Pending", "Rejected", "Disconnected" ], "x-ms-enum": { "name": "PrivateEndpointServiceConnectionStatus", "modelAsString": true } }, "PrivateEndpointConnectionProvisioningState": { "type": "string", "readOnly": true, "description": "The current provisioning state.", "enum": [ "Succeeded", "Provisioning", "Failed" ], "x-ms-enum": { "name": "PrivateEndpointConnectionProvisioningState", "modelAsString": true } }, "TagsResource": { "properties": { "tags": { "additionalProperties": { "type": "string" }, "description": "Resource tags", "type": "object" } }, "type": "object", "description": "A container holding only the Tags for a resource, allowing the user to update the tags on a PrivateLinkConnection instance." } }, "parameters": { "privateEndpointConnectionName": { "name": "privateEndpointConnectionName", "in": "path", "required": true, "type": "string", "minLength": 1, "x-ms-parameter-location": "method", "description": "The PrivateEndpointConnection name." }, "subscriptionIdParameter": { "name": "subscriptionId", "in": "path", "description": "Azure subscription ID.", "required": true, "type": "string", "x-ms-parameter-location": "client" }, "apiVersionParameter": { "name": "api-version", "in": "query", "required": true, "type": "string", "x-ms-parameter-location": "client", "description": "Version of the API to be used with the client request." }, "resourceGroupNameParameter": { "name": "resourceGroupName", "in": "path", "required": true, "type": "string", "pattern": "^[-\\w\\._\\(\\)]+$", "minLength": 1, "maxLength": 90, "x-ms-parameter-location": "method", "description": "Name of an Azure resource group." }, "groupNameParameter": { "name": "groupName", "in": "path", "description": "The name of the private link resource.", "required": true, "x-ms-parameter-location": "method", "type": "string" }, "policyNameParameter": { "name": "policyName", "in": "path", "required": true, "type": "string", "description": "The name of the private link policy in Azure AD.", "x-ms-parameter-location": "method" } } }