CommunicationNetworkTraversal.json

{
  "swagger": "2.0",
  "info": {
    "title": "CommunicationNetworkingClient",
    "description": "Azure Communication Networking Service",
    "version": "2021-06-21-preview"
  },
  "paths": {
    "/networktraversal/:issueRelayConfiguration": {
      "post": {
        "tags": [
          "Turn"
        ],
        "summary": "Issue a configuration for an STUN/TURN server for an existing identity.",
        "operationId": "CommunicationNetworkTraversal_IssueRelayConfiguration",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "$ref": "#/parameters/ApiVersionParameter"
          },
          {
            "in": "body",
            "name": "body",
            "schema": {
              "$ref": "#/definitions/CommunicationRelayConfigurationRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "schema": {
              "$ref": "#/definitions/CommunicationRelayConfiguration"
            }
          },
          "default": {
            "description": "Error",
            "schema": {
              "$ref": "../../../Common/stable/2021-03-07/common.json#/definitions/CommunicationErrorResponse"
            }
          }
        },
        "x-ms-examples": {
          "Issue Relay Configuration": {
            "$ref": "./examples/IssueRelayConfiguration.json"
          }
        }
      }
    }
  },
  "definitions": {
    "CommunicationRelayConfigurationRequest": {
      "description": "Request for a CommunicationRelayConfiguration.",
      "type": "object",
      "properties": {
        "id": {
          "description": "An existing ACS identity.",
          "type": "string"
        }
      }
    },
    "CommunicationIceServer": {
      "description": "An instance of a STUN/TURN server with credentials to be used for ICE negotiation.",
      "required": [
        "credential",
        "urls",
        "username"
      ],
      "type": "object",
      "properties": {
        "urls": {
          "description": "List of STUN/TURN server URLs.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "username": {
          "description": "User account name which uniquely identifies the credentials.",
          "type": "string"
        },
        "credential": {
          "description": "Credential for the server.",
          "type": "string"
        }
      }
    },
    "CommunicationRelayConfiguration": {
      "description": "A relay configuration containing the STUN/TURN URLs and credentials.",
      "required": [
        "expiresOn",
        "iceServers"
      ],
      "type": "object",
      "properties": {
        "expiresOn": {
          "format": "date-time",
          "description": "The date for which the username and credentials are not longer valid.",
          "type": "string"
        },
        "iceServers": {
          "description": "An array representing the credentials and the STUN/TURN server URLs for use in ICE negotiations.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/CommunicationIceServer"
          }
        }
      }
    }
  },
  "parameters": {
    "ApiVersionParameter": {
      "in": "query",
      "name": "api-version",
      "description": "Version of API to invoke.",
      "required": true,
      "enum": [
        "2021-06-21-preview"
      ],
      "type": "string"
    }
  },
  "securityDefinitions": {
    "azure_auth": {
      "type": "oauth2",
      "flow": "implicit",
      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
      "scopes": {
        "user_impersonation": "impersonate your user account"
      }
    }
  },
  "x-ms-parameterized-host": {
    "hostTemplate": "{endpoint}",
    "useSchemePrefix": false,
    "parameters": [
      {
        "name": "endpoint",
        "description": "The communication resource, for example https://my-resource.communication.azure.com",
        "required": true,
        "type": "string",
        "in": "path",
        "x-ms-skip-url-encoding": true,
        "x-ms-parameter-location": "client"
      }
    ]
  }
}