swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Contacts API
schemes:
- https
tags:
- name: Contacts
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VoiceServices/communicationsGateways/{communicationsGatewayName}/contacts
  : get:
      tags:
      - Contacts
      operationId: microsoftAzureContactsListbycommunicationsgateway
      description: List Contact resources by CommunicationsGateway
      parameters:
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/parameters/CommunicationsGateway.communicationsGatewayName'
      responses:
        '200':
          description: ARM operation completed successfully.
          schema:
            $ref: '#/definitions/ContactListResult'
        default:
          description: An unexpected error response.
          schema:
            $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        ListContactsResource:
          $ref: ./examples/Contacts_ListByCommunicationsGateway.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Voiceservices Communicationsgateways Communicationsgatewayname Contacts
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VoiceServices/communicationsGateways/{communicationsGatewayName}/contacts/{contactName}
  : get:
      tags:
      - Contacts
      operationId: microsoftAzureContactsGet
      description: Get a Contact
      parameters:
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/parameters/CommunicationsGateway.communicationsGatewayName'
      - $ref: '#/parameters/Contact.contactName'
      responses:
        '200':
          description: ARM operation completed successfully.
          schema:
            $ref: '#/definitions/Contact'
        default:
          description: An unexpected error response.
          schema:
            $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse
      x-ms-examples:
        GetContactResource:
          $ref: ./examples/Contacts_Get.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Voiceservices Communicationsgateways Communicationsgatewayname Contacts Contactname
    put:
      tags:
      - Contacts
      operationId: microsoftAzureContactsCreateorupdate
      description: Create a Contact
      parameters:
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/parameters/CommunicationsGateway.communicationsGatewayName'
      - $ref: '#/parameters/Contact.contactName'
      - name: resource
        in: body
        required: true
        description: Resource create parameters.
        schema:
          $ref: '#/definitions/Contact'
      responses:
        '200':
          description: ARM operation completed successfully.
          schema:
            $ref: '#/definitions/Contact'
        '201':
          description: ARM create operation completed successfully.
          headers:
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              type: integer
              format: int32
          schema:
            $ref: '#/definitions/Contact'
        default:
          description: An unexpected error response.
          schema:
            $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse
      x-ms-examples:
        CreateContactResource:
          $ref: ./examples/Contacts_CreateOrUpdate.json
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      x-ms-long-running-operation: true
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Voiceservices Communicationsgateways Communicationsgatewayname Contacts Contactname
    delete:
      tags:
      - Contacts
      operationId: microsoftAzureContactsDelete
      description: Delete a Contact
      parameters:
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/parameters/CommunicationsGateway.communicationsGatewayName'
      - $ref: '#/parameters/Contact.contactName'
      responses:
        '200':
          description: Resource deleted successfully.
        '202':
          description: Resource deletion accepted.
          headers:
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              type: integer
              format: int32
        '204':
          description: Resource deleted successfully.
        default:
          description: An unexpected error response.
          schema:
            $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse
      x-ms-examples:
        DeleteContactResource:
          $ref: ./examples/Contacts_Delete.json
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      x-ms-long-running-operation: true
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Voiceservices Communicationsgateways Communicationsgatewayname Contacts Contactname
    patch:
      tags:
      - Contacts
      operationId: microsoftAzureContactsUpdate
      description: Update a Contact
      parameters:
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/parameters/CommunicationsGateway.communicationsGatewayName'
      - $ref: '#/parameters/Contact.contactName'
      - name: properties
        in: body
        required: true
        description: The resource properties to be updated.
        schema:
          $ref: '#/definitions/ContactUpdate'
      responses:
        '200':
          description: ARM operation completed successfully.
          schema:
            $ref: '#/definitions/Contact'
        default:
          description: An unexpected error response.
          schema:
            $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse
      x-ms-examples:
        UpdateContactResource:
          $ref: ./examples/Contacts_Update.json
      summary: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Voiceservices Communicationsgateways Communicationsgatewayname Contacts Contactname
definitions:
  ContactListResult:
    type: object
    properties:
      value:
        type: array
        items:
          $ref: '#/definitions/Contact'
        x-cadl-name: Contact[]
        description: The Contact items on this page
      nextLink:
        type: string
        description: The link to the next page of items
        x-cadl-name: Rest.ResourceLocation<Contact>
    description: The response of a Contact list operation.
    required:
    - value
  ContactUpdate:
    type: object
    properties:
      tags:
        type: object
        additionalProperties:
          type: string
        x-cadl-name: Record<string>
        description: Resource tags.
    description: The type used for update operations of the Contact.
  ProvisioningState:
    type: string
    description: Provisioning state of the resource.
    enum:
    - Succeeded
    - Failed
    - Canceled
    x-ms-enum:
      name: ProvisioningState
      modelAsString: true
  ContactProperties:
    type: object
    properties:
      provisioningState:
        $ref: '#/definitions/ProvisioningState'
        description: Resource provisioning state.
        readOnly: true
      contactName:
        type: string
        description: Full name of contact
        x-ms-mutability:
        - read
        - update
        - create
      phoneNumber:
        type: string
        description: Telephone number of contact
        x-ms-mutability:
        - read
        - update
        - create
      email:
        type: string
        description: Email address of contact
        x-ms-mutability:
        - read
        - update
        - create
      role:
        type: string
        description: Job title of contact
        x-ms-mutability:
        - read
        - update
        - create
    description: Details of the Contact resource.
    required:
    - contactName
    - phoneNumber
    - email
    - role
  Contact:
    type: object
    properties:
      properties:
        $ref: '#/definitions/ContactProperties'
        description: The resource-specific properties for this resource.
        x-ms-mutability:
        - read
        - create
        x-ms-client-flatten: true
    description: A Contact resource
    allOf:
    - $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/TrackedResource
parameters:
  Contact.contactName:
    name: contactName
    in: path
    required: true
    description: Unique identifier for this contact
    pattern: ^[a-zA-Z0-9-]{3,24}$
    type: string
    x-ms-parameter-location: method
  CommunicationsGateway.communicationsGatewayName:
    name: communicationsGatewayName
    in: path
    required: true
    description: Unique identifier for this deployment
    pattern: ^[a-zA-Z0-9-]{3,24}$
    type: string
    x-ms-parameter-location: method
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'