swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector NspLinks API
schemes:
- https
tags:
- name: NspLinks
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/links/{linkName}
  : parameters:
    - $ref: ./network.json#/parameters/SubscriptionIdParameter
    - $ref: '#/parameters/ResourceGroupNameParameter'
    - $ref: '#/parameters/NetworkSecurityPerimeterNameParameter'
    - $ref: '#/parameters/LinkNameParameter'
    - $ref: ./network.json#/parameters/ApiVersionParameter
    get:
      tags:
      - NspLinks
      operationId: microsoftAzureNsplinksGet
      description: Gets the specified NSP link resource.
      responses:
        '200':
          description: OK - Returns NSP link resource.
          schema:
            $ref: '#/definitions/NspLink'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: ./network.json#/definitions/CloudError
      x-ms-examples:
        NspLinksGet:
          $ref: ./examples/NspLinkGet.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Networksecurityperimeters Networksecurityperimetername Links Linkname
    put:
      tags:
      - NspLinks
      operationId: microsoftAzureNsplinksCreateorupdate
      description: Creates or updates NSP link resource.
      parameters:
      - name: parameters
        in: body
        required: true
        schema:
          $ref: '#/definitions/NspLink'
        description: Parameters that hold the NspLink resource to be created/updated.
      responses:
        '200':
          description: Updated - Existing NspLink resource is updated. Returns the resource.
          schema:
            $ref: '#/definitions/NspLink'
        '201':
          description: Create - Returns the NspLink resource created.
          schema:
            $ref: '#/definitions/NspLink'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: ./network.json#/definitions/CloudError
      x-ms-examples:
        NspLinksPut:
          $ref: ./examples/NspLinkPut.json
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Networksecurityperimeters Networksecurityperimetername Links Linkname
    delete:
      tags:
      - NspLinks
      operationId: microsoftAzureNsplinksDelete
      description: Deletes an NSP Link resource.
      responses:
        '200':
          description: Delete Succeed.
        '202':
          description: Delete in progress.
          headers:
            location:
              description: location header
              type: string
        '204':
          description: Request successful. The resource does not exist.
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: ./network.json#/definitions/CloudError
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: location
      x-ms-examples:
        NspLinkDelete:
          $ref: ./examples/NspLinkDelete.json
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Networksecurityperimeters Networksecurityperimetername Links Linkname
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/links
  : get:
      tags:
      - NspLinks
      operationId: microsoftAzureNsplinksList
      description: Lists the NSP Link resources in the specified network security perimeter.
      x-ms-pageable:
        nextLinkName: nextLink
      parameters:
      - $ref: ./network.json#/parameters/SubscriptionIdParameter
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/NetworkSecurityPerimeterNameParameter'
      - $ref: ./network.json#/parameters/ApiVersionParameter
      - $ref: '#/parameters/ListTopParameter'
      - $ref: '#/parameters/ListSkipTokenParameter'
      responses:
        '200':
          description: OK - Returns the list of NSP link resources.
          schema:
            $ref: '#/definitions/NspLinkListResult'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: ./network.json#/definitions/CloudError
      x-ms-examples:
        NspLinkList:
          $ref: ./examples/NspLinkList.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Networksecurityperimeters Networksecurityperimetername Links
definitions:
  NspLink:
    type: object
    properties:
      properties:
        x-ms-client-flatten: true
        $ref: '#/definitions/NspLinkProperties'
        description: Properties of the network security perimeter link resource.
    allOf:
    - $ref: ./network.json#/definitions/ProxyResource
    description: The network security perimeter link resource
  NspLinkProperties:
    type: object
    properties:
      provisioningState:
        readOnly: true
        $ref: '#/definitions/NSPLinkProvisioningState'
        description: The provisioning state of the NSP Link resource.
      autoApprovedRemotePerimeterResourceId:
        type: string
        description: Perimeter ARM Id for the remote NSP with which the link gets created in Auto-approval mode. It should be used when the NSP admin have Microsoft.Network/networkSecurityPerimeters/linkPerimeter/action permission on the remote NSP resource.
        x-ms-mutability:
        - read
        - create
      remotePerimeterGuid:
        readOnly: true
        type: string
        description: Remote NSP Guid with which the link gets created.
      remotePerimeterLocation:
        readOnly: true
        type: string
        description: Remote NSP location with which the link gets created.
      localInboundProfiles:
        type: array
        items:
          type: string
        description: Local Inbound profile names to which Inbound is allowed. Use ['*'] to allow inbound to all profiles.
        uniqueItems: true
      localOutboundProfiles:
        type: array
        items:
          type: string
        readOnly: true
        description: Local Outbound profile names from which Outbound is allowed. In current version, it is readonly property and it's value is set to ['*'] to allow outbound from all profiles. In later version, user will be able to modify it.
        uniqueItems: true
      remoteInboundProfiles:
        type: array
        items:
          type: string
        description: Remote Inbound profile names to which Inbound is allowed. Use ['*'] to allow inbound to all profiles. This property can only be updated in auto-approval mode.
        uniqueItems: true
      remoteOutboundProfiles:
        type: array
        items:
          type: string
        readOnly: true
        description: Remote Outbound profile names from which Outbound is allowed. In current version, it is readonly property and it's value is set to ['*'] to allow outbound from all profiles. In later version, user will be able to modify it.
        uniqueItems: true
      description:
        type: string
        description: A message passed to the owner of the remote NSP link resource with this connection request. In case of Auto-approved flow, it is default to 'Auto Approved'. Restricted to 140 chars.
      status:
        type: string
        readOnly: true
        description: The NSP link state.
        enum:
        - Approved
        - Pending
        - Rejected
        - Disconnected
        x-ms-enum:
          name: nspLinkStatus
          modelAsString: true
    description: Properties of NSP Link resource.
  NSPLinkProvisioningState:
    type: string
    readOnly: true
    description: The current provisioning state of NSP Link/LinkReference.
    enum:
    - Succeeded
    - Creating
    - Updating
    - Deleting
    - Accepted
    - Failed
    - WaitForRemoteCompletion
    x-ms-enum:
      name: nspLinkProvisioningState
      modelAsString: true
  NspLinkListResult:
    type: object
    properties:
      value:
        type: array
        items:
          $ref: '#/definitions/NspLink'
        description: Gets a page of NSP Link resources.
      nextLink:
        type: string
        description: Gets the URL to get the next page of results.
    description: Result of the request to list NSP link resources. Contains a list of NSP link resources and a URL link to get the next set of results.
parameters:
  ListTopParameter:
    name: $top
    description: An optional query parameter which specifies the maximum number of records to be returned by the server.
    in: query
    required: false
    type: integer
    format: int32
    minimum: 1
    maximum: 20
    x-ms-parameter-location: method
  LinkNameParameter:
    name: linkName
    in: path
    required: true
    type: string
    description: The name of the NSP link.
    x-ms-parameter-location: method
  NetworkSecurityPerimeterNameParameter:
    name: networkSecurityPerimeterName
    in: path
    required: true
    type: string
    description: The name of the network security perimeter.
    x-ms-parameter-location: method
  ListSkipTokenParameter:
    name: $skipToken
    description: SkipToken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skipToken parameter that specifies a starting point to use for subsequent calls.
    in: query
    required: false
    type: string
    x-ms-parameter-location: method
  ResourceGroupNameParameter:
    name: resourceGroupName
    in: path
    required: true
    type: string
    description: The name of the resource group.
    x-ms-parameter-location: method
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'