openapi: 3.0.1
info:
  title: FlashArray REST Active Directory File System Replica Links API
  version: '2.52'
  description: 'Active Directory configuration authenticates users for NFS using Kerberos or SMB using Kerberos

    or New Technology LAN Manager (NTLM). Active Directory is also used to authorize users by

    mapping identities across the NFS and SMB protocols by using LDAP queries.

    '
servers:
- url: /
tags:
- name: File System Replica Links
  description: File system replication requires a replica link that connects a source array to a remote target. The configuration of a replica link includes policies, file system names, remote names, and replication status information.
paths:
  /api/2.26/file-system-replica-links:
    get:
      tags:
      - File System Replica Links
      summary: Pure Storage GET File-system-replica-links
      description: List file system replication link.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Local_file_system_ids'
      - $ref: '#/components/parameters/Local_file_system_names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Remote_file_system_ids'
      - $ref: '#/components/parameters/Remote_file_system_names'
      - $ref: '#/components/parameters/Remote_ids'
      - $ref: '#/components/parameters/Remote_names'
      - $ref: '#/components/parameters/Sort'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileSystemReplicaLinkGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileSystemReplicaLinkGetResponse'
    post:
      tags:
      - File System Replica Links
      summary: Pure Storage POST File-system-replica-links
      description: Create a file system replication link.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Local_file_system_ids'
      - $ref: '#/components/parameters/Local_file_system_names'
      - $ref: '#/components/parameters/Remote_default_exports'
      - $ref: '#/components/parameters/Remote_file_system_names'
      - $ref: '#/components/parameters/Remote_ids'
      - $ref: '#/components/parameters/Remote_names'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileSystemReplicaLink'
        required: true
        x-codegen-request-body-name: file-system-replica-link
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileSystemReplicaLinkResponse'
      x-codegen-request-body-name: file-system-replica-link
    delete:
      tags:
      - File System Replica Links
      summary: Pure Storage DELETE File-system-replica-links
      description: Delete a file system replication link.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Cancel_in_progress_transfers'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Local_file_system_ids'
      - $ref: '#/components/parameters/Local_file_system_names'
      - $ref: '#/components/parameters/Remote_file_system_ids'
      - $ref: '#/components/parameters/Remote_file_system_names'
      - $ref: '#/components/parameters/Remote_ids'
      - $ref: '#/components/parameters/Remote_names'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content: {}
    patch:
      tags:
      - File System Replica Links
      summary: Pure Storage PATCH File-system-replica-links
      description: Update a file system replication link.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Local_file_system_ids'
      - $ref: '#/components/parameters/Local_file_system_names'
      - $ref: '#/components/parameters/Remote_ids'
      - $ref: '#/components/parameters/Remote_names'
      - $ref: '#/components/parameters/Replicate_now'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileSystemReplicaLinkResponse'
  /api/2.26/file-system-replica-links/policies:
    get:
      tags:
      - File System Replica Links
      summary: Pure Storage GET File-system-replica-links/policies
      description: List file system replication link policies.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Local_file_system_ids'
      - $ref: '#/components/parameters/Local_file_system_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      - $ref: '#/components/parameters/Remote_file_system_ids'
      - $ref: '#/components/parameters/Remote_file_system_names'
      - $ref: '#/components/parameters/Remote_ids'
      - $ref: '#/components/parameters/Remote_names'
      - $ref: '#/components/parameters/Sort'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberWithRemoteGetResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberWithRemoteGetResponse'
    post:
      tags:
      - File System Replica Links
      summary: Pure Storage POST File-system-replica-links/policies
      description: Add a policy to a file system replication link.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Local_file_system_ids'
      - $ref: '#/components/parameters/Local_file_system_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      - $ref: '#/components/parameters/Remote_ids'
      - $ref: '#/components/parameters/Remote_names'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMemberWithRemoteResponse'
    delete:
      tags:
      - File System Replica Links
      summary: Pure Storage DELETE File-system-replica-links/policies
      description: Remove a policy from a file system replication link.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Context_names'
      - $ref: '#/components/parameters/Local_file_system_ids'
      - $ref: '#/components/parameters/Local_file_system_names'
      - $ref: '#/components/parameters/Member_ids'
      - $ref: '#/components/parameters/Policy_ids'
      - $ref: '#/components/parameters/Policy_names'
      - $ref: '#/components/parameters/Remote_ids'
      - $ref: '#/components/parameters/Remote_names'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content: {}
  /api/2.26/file-system-replica-links/transfer:
    get:
      tags:
      - File System Replica Links
      summary: Pure Storage GET File-system-replica-links/transfer
      description: List the transfer status details for file system replication.
      parameters:
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Allow_errors'
      - $ref: '#/components/parameters/Context_names_get'
      - $ref: '#/components/parameters/Continuation_token'
      - $ref: '#/components/parameters/Filter'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Names_or_owner_names'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Remote_ids'
      - $ref: '#/components/parameters/Remote_names'
      - $ref: '#/components/parameters/Sort'
      - $ref: '#/components/parameters/Total_only'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileSystemSnapshotGetTransferResponse'
        '207':
          description: 'Partial success. Some resources were returned, but there

            were also errors possibly preventing some resources from

            being returned.

            '
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileSystemSnapshotGetTransferResponse'
  /api/1.5/file-system-replica-links:
    get:
      tags:
      - File System Replica Links
      summary: Pure Storage Get FlashBlade File System Replica Links
      description: 'Retrieves information about FlashBlade file system replica links.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token_2'
      - $ref: '#/components/parameters/Filter_2'
      - $ref: '#/components/parameters/Ids_2'
      - $ref: '#/components/parameters/Limit_2'
      - $ref: '#/components/parameters/Member_ids_plus'
      - $ref: '#/components/parameters/Member_names_plus'
      - $ref: '#/components/parameters/Offset_2'
      - $ref: '#/components/parameters/Sort_2'
      - $ref: '#/components/parameters/Source_ids_plus'
      - $ref: '#/components/parameters/Source_names_plus'
      - $ref: '#/components/parameters/Target_ids_plus'
      - $ref: '#/components/parameters/Target_names_plus'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: 'The number of requests remaining for the organization in that second.

                '
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: 'The number of requests remaining for the organization in that minute.

                '
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileSystemReplicaLinkGetResponse_2'
        '400':
          $ref: '#/components/responses/Error400'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
  /api/1.5/file-system-replica-links/policies:
    get:
      tags:
      - File System Replica Links
      summary: Pure Storage Get FlashBlade File System Replica Link / Policy Pairs
      description: 'Retrieves pairs of FlashBlade file system replica link members and their policies.

        '
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XRequestId'
      - $ref: '#/components/parameters/Continuation_token_2'
      - $ref: '#/components/parameters/Filter_2'
      - $ref: '#/components/parameters/Limit_2'
      - $ref: '#/components/parameters/Member_ids_2'
      - $ref: '#/components/parameters/Member_names'
      - $ref: '#/components/parameters/Offset_2'
      - $ref: '#/components/parameters/Policy_ids_2'
      - $ref: '#/components/parameters/Policy_names_2'
      - $ref: '#/components/parameters/Sort_2'
      responses:
        '200':
          description: OK
          headers:
            X-Request-ID:
              description: Supplied by client during request or generated by server.
              schema:
                type: string
            X-RateLimit-Remaining-second:
              description: 'The number of requests remaining for the organization in that second.

                '
              schema:
                type: integer
            X-RateLimit-Remaining-minute:
              description: 'The number of requests remaining for the organization in that minute.

                '
              schema:
                type: integer
            X-RateLimit-Limit-second:
              description: The number of requests available per second.
              schema:
                type: integer
            X-RateLimit-Limit-minute:
              description: The number of requests available per minute.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyMembersGetResponse'
        '400':
          $ref: '#/components/responses/Error400'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
components:
  schemas:
    _fixedReferenceNoResourceType:
      type: object
      properties:
        id:
          description: 'A non-modifiable, globally unique ID chosen by the system.

            '
          type: string
          readOnly: true
        name:
          type: string
          readOnly: true
      x-readOnly: true
    FileSystemReplicaLinkGetResponse_2:
      allOf:
      - $ref: '#/components/schemas/PageInfo_2'
      - $ref: '#/components/schemas/FileSystemReplicaLinkResponse_2'
    _timeAware:
      type: object
      properties:
        _as_of:
          description: The freshness of the data (timestamp in millis since epoch).
          type: integer
          format: int64
          readOnly: true
          example: 1502729489760
    ErrorNoContext:
      type: object
      properties:
        message:
          type: string
          example: Something was wrong
    PolicyMemberWithRemote:
      allOf:
      - $ref: '#/components/schemas/_context'
      - $ref: '#/components/schemas/PolicyFileSystemSnapshot'
      - type: object
        properties:
          link:
            description: 'Only populated if the `member` is a file system replica link. Contains additional

              information about the link.

              '
            title: MemberLink
            allOf:
            - $ref: '#/components/schemas/_memberLink'
    PolicyMemberWithRemoteResponse:
      allOf:
      - $ref: '#/components/schemas/_context'
      - type: object
        properties:
          items:
            description: A list of members for policies.
            type: array
            items:
              $ref: '#/components/schemas/PolicyMemberWithRemote'
    _builtIn:
      type: object
      properties:
        id:
          description: 'A non-modifiable, globally unique ID chosen by the system.

            '
          type: string
          readOnly: true
        name:
          description: Name of the object (e.g., a file system or snapshot).
          type: string
          readOnly: true
    FileSystemSnapshotTransferResponse:
      type: object
      properties:
        items:
          description: A list of file system snapshot objects.
          type: array
          items:
            $ref: '#/components/schemas/FileSystemSnapshotTransfer'
    PolicyMembersGetResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo_2'
      - $ref: '#/components/schemas/PolicyMembersResponse'
    PolicyMembersResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/PolicyMember_2'
    PolicyFileSystemSnapshot:
      allOf:
      - $ref: '#/components/schemas/PolicyMember'
      - $ref: '#/components/schemas/_context'
      - type: object
        properties:
          policy:
            description: Reference to the policy. Location can be array or realm.
            title: LocationReference
            allOf:
            - $ref: '#/components/schemas/_locationReference'
    PolicyMember:
      type: object
      properties:
        member:
          description: Reference to the resource the policy is applied to.
          title: FixedReference
          allOf:
          - $ref: '#/components/schemas/_fixedReference'
        policy:
          description: Reference to the policy.
          title: FixedReference
          allOf:
          - $ref: '#/components/schemas/_fixedReference'
    FileSystemReplicaLinkResponse_2:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/FileSystemReplicaLink_2'
    _locationReference:
      allOf:
      - $ref: '#/components/schemas/_reference'
      - type: object
        properties:
          display_name:
            description: 'Full name of the source with remote array information.

              Response will be same as source name for local file systems and policies.

              '
            type: string
            readOnly: true
            example: irp624-c02:fs1
          is_local:
            description: 'Is the location reference to the local array or somewhere remote?

              '
            type: boolean
            readOnly: true
          location:
            description: 'A reference to the location where the object is defined.

              '
            title: Reference
            allOf:
            - $ref: '#/components/schemas/_reference'
    _errorErrors:
      type: object
      properties:
        context:
          type: string
          example: Error with ...
        message:
          type: string
          example: Something was wrong
    FileSystemSnapshotGetTransferResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo'
      - $ref: '#/components/schemas/FileSystemSnapshotTransferResponse'
      - $ref: '#/components/schemas/_errorContextResponse'
      - type: object
        properties:
          total:
            description: 'If `total_only` query param is `true`, then it will be a total of

              all records after filtering and no items will be returned.

              If `total_only` is `false`, then it will be a total of all records

              on this page.

              '
            title: FileSystemSnapshotTransfer
            allOf:
            - $ref: '#/components/schemas/FileSystemSnapshotTransfer'
    FileSystemReplicaLinkGetResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo'
      - $ref: '#/components/schemas/FileSystemReplicaLinkResponse'
      - $ref: '#/components/schemas/_errorContextResponse'
    PolicyMember_2:
      description: An association between a policy and a member.
      allOf:
      - $ref: '#/components/schemas/_timeAware'
      - type: object
        properties:
          member:
            $ref: '#/components/schemas/_fixedReference_2'
          policy:
            $ref: '#/components/schemas/_fixedReference_2'
    _replicaLinkBuiltIn:
      allOf:
      - $ref: '#/components/schemas/_builtInRelationship'
      - type: object
        properties:
          direction:
            $ref: '#/components/schemas/_direction'
          lag:
            description: 'Duration in milliseconds that represents how far

              behind the replication target is from the source.

              This is the time difference between current time and `recovery_point`.

              '
            type: integer
            format: int64
            readOnly: true
          status_details:
            description: 'Detailed information about the status of the replica link when it is

              unhealthy.

              '
            type: string
            readOnly: true
    _resourceWithLocation:
      description: 'An ordinary resource that exists in one location.

        '
      allOf:
      - $ref: '#/components/schemas/_fixedReference_2'
      - type: object
        properties:
          location:
            $ref: '#/components/schemas/_fixedReferenceFqdn'
    _fixedReferenceFqdn:
      allOf:
      - $ref: '#/components/schemas/_fixedReference_2'
      - type: object
        properties:
          fqdn:
            description: 'The fully qualified domain name of the appliance when `resource_type` is `arrays`,

              `null` otherwise.

              '
            type: string
            readOnly: true
            example: example_name.dc1.example.com
    _fixedReference_2:
      type: object
      properties:
        id:
          description: The opaque and unique id of this resource.
          type: string
          readOnly: true
          example: 2a989a09-c851-4d52-9ec6-ab728b1c04db
        name:
          description: The name of this resource.
          type: string
          readOnly: true
          example: example_name
        resource_type:
          description: 'The type of this resource represented by the name of its REST endpoint.

            For example, "arrays", "network-interfaces", and "metrics".

            The value may be `null` if the resource is not represented.

            '
          type: string
          readOnly: true
          example: example_resource_type
      x-readOnly: true
    _builtInRelationship:
      type: object
      properties:
        id:
          description: 'A non-modifiable, globally unique ID chosen by the system.

            '
          type: string
          readOnly: true
    FileSystemSnapshotTransfer:
      allOf:
      - $ref: '#/components/schemas/_builtIn'
      - $ref: '#/components/schemas/_context'
      - type: object
        properties:
          completed:
            description: 'A timestamp at which the replication of the snapshot completed.

              '
            type: integer
            format: int64
            readOnly: true
          data_transferred:
            description: The amount of data transferred to the target, in bytes.
            type: integer
            format: int64
            readOnly: true
          direction:
            $ref: '#/components/schemas/_direction'
          local_snapshot:
            description: 'A reference to the associated local file system snapshot.

              '
            title: FixedReferenceNoResourceType
            allOf:
            - $ref: '#/components/schemas/_fixedReferenceNoResourceType'
          progress:
            description: 'A percentage that indicates

              how much progress has been made on the transfer.

              '
            type: number
            format: double
            minimum: 0
            maximum: 1
            readOnly: true
          remote:
            description: 'The array or realm where the remote file system snapshot is located.

              '
            title: FixedReference
            allOf:
            - $ref: '#/components/schemas/_fixedReference'
          remote_snapshot:
            description: 'A reference to the associated remote file system snapshot.

              '
            title: FixedReferenceNoResourceType
            allOf:
            - $ref: '#/components/schemas/_fixedReferenceNoResourceType'
          started:
            description: 'A timestamp at which the replication of the snapshot started.

              '
            type: integer
            format: int64
            readOnly: true
          status:
            description: 'The status of current replication.

              Valid values are `completed`, `in-progress`, and `queued`.

              '
            type: string
            readOnly: true
    PageInfo:
      type: object
      properties:
        continuation_token:
          description: 'Continuation token that can be provided in the `continuation_token` query

            param to get the next page of data.

            If you use the `continuation_token` to page through data you

            are guaranteed to get all items exactly once regardless of

            how items are modified. If an item is added or deleted during

            the pagination then it may or may not be returned.

            The `continuation_token` is generated if the `limit` is less

            than the remaining number of items, and the default sort is used

            (no sort is specified).

            '
          type: string
        total_item_count:
          description: Total number of items after applying `filter` params.
          type: integer
          format: int32
    _errorContextResponse:
      type: object
      properties:
        errors:
          description: The list of errors encountered when attempting to perform an operation.
          type: array
          readOnly: true
          items:
            $ref: '#/components/schemas/_errorContextResponseErrors'
    Error:
      type: object
      properties:
        errors:
          description: The list of errors encountered.
          type: array
          items:
            $ref: '#/components/schemas/_errorErrors'
    _reference:
      type: object
      properties:
        id:
          description: 'A globally unique, system-generated ID.

            The ID cannot be modified.

            '
          type: string
        name:
          description: 'The resource name,

            such as volume name, pod name, snapshot name, and so on.

            '
          type: string
        resource_type:
          description: 'Type of the object (full name of the endpoint).

            Valid values are `hosts`, `host-groups`, `network-interfaces`, `pods`,

            `ports`, `pod-replica-links`, `subnets`, `volumes`, `volume-snapshots`,

            `volume-groups`, `directories`, `policies/nfs`, `policies/smb`, and

            `policies/snapshot`, etc.

            '
          type: string
          readOnly: true
      x-aliases:
      - _referenceWithFixedType
    PolicyMemberWithRemoteGetResponse:
      allOf:
      - $ref: '#/components/schemas/PageInfo'
      - $ref: '#/components/schemas/PolicyMemberWithRemoteResponse'
      - $ref: '#/components/schemas/_errorContextResponse'
    _context:
      type: object
      properties:
        context:
          description: 'The context in which the operation was performed.


            Valid values include a reference to any array which is a member of the same fleet

            or to the fleet itself.


            Other parameters provided with the request, such as names of volumes or snapshots,

            are resolved relative to the provided `context`.

            '
          readOnly: true
          title: FixedReference
          allOf:
          - $ref: '#/components/schemas/_fixedReference'
    FileSystemReplicaLink_2:
      description: A replica link between two FlashBlade file systems.
      allOf:
      - $ref: '#/components/schemas/_replicaLink'
      - description: A replica link between two FlashBlade file systems.
        type: object
        properties:
          members:
            description: 'The union of source and target file systems in the replica link.

              '
            type: array
            items:
              $ref: '#/components/schemas/_resourceWithLocation'
          recovery_point:
            description: 'Time when the last replicated snapshot was created, in milliseconds

              since the UNIX epoch. (i.e. the recovery point if the file system is

              promoted.)

              '
            type: integer
            format: int64
            readOnly: true
            example: 1565034592494
          sources:
            description: The source file systems in the replica link.
            type: array
            items:
              $ref: '#/components/schemas/_resourceWithLocation'
          status_details:
            description: 'Detailed information about the status of the replica link when it is

              `unhealthy`.

              '
            type: string
          targets:
            description: The target file systems in the replica link.
            type: array
            items:
              $ref: '#/components/schemas/_resourceWithLocation'
    FileSystemReplicaLinkResponse:
      type: object
      properties:
        items:
          description: A list of file system replica link objects.
          type: array
          items:
            $ref: '#/components/schemas/FileSystemReplicaLink'
    FileSystemReplicaLink:
      allOf:
      - $ref: '#/components/schemas/_replicaLinkBuiltIn'
      - $ref: '#/components/schemas/_context'
      - type: object
        properties:
          link_type:
            description: 'Type of the replica link.

              Values include `full-replica`, and `partial-replica`.

              '
            type: string
          local_file_system:
            description: Reference to a local file system.
            title: FixedReference
            allOf:
            - $ref: '#/components/schemas/_fixedReference'
          policies:
            type: array
            items:
              description: Reference to a policy that is driving replication.
              title: LocationReference
              allOf:
              - $ref: '#/components/schemas/_locationReference'
          recovery_point:
            description: 'Time when the last replicated snapshot was created, in milliseconds

              since UNIX epoch. I.e. the recovery point if the file system is promoted.

              '
            type: integer
            format: int64
            readOnly: true
            example: 1565034592494
          remote:
            description: Reference to a remote array or realm.
            title: FixedReference
            allOf:
            - $ref: '#/components/schemas/_fixedReference'
          remote_file_system:
            description: Reference to a remote file system.
            title: FixedReferenceNoResourceType
            allOf:
            - $ref: '#/components/schemas/_fixedReferenceNoResourceType'
          status:
            description: 'Status of the replica link.

              Values include `replicating`, `idle`, and `unhealthy`.

              '
            type: string
            readOnly: true
    PageInfo_2:
      type: object
      properties:
        continuation_token:
          description: 'Continuation token that can be provided in the continuation_token

            query param to get the next page of data.

            If you use the continuation token to page through data you

            are guaranteed to get all items exactly once regardless of

            how items are modified. If an item is added or deleted during

            the pagination then it may or may not be returned.

            The continuation token is generated if the limit is less

            than the remaining number of items, and the default sort is used

            (no sort is specified).

            '
          type: string
          example: MThkMzJmYWUtZDI3OS00ODEzLWIzODYtMmM3NmFhMTMwM2My
        total_item_count:
          description: Total number of items after applying filter params.
          type: integer
          format: int32
          example: 1
    _memberLink:
      type: object
      properties:
        local_file_system:
          description: Reference to a local file system.
          title: FixedReference
          allOf:
          - $ref: '#/components/schemas/_fixedReference'
        remote:
          description: Reference to a remote array or realm.
          title: FixedReference
          allOf:
          - $ref: '#/components/schemas/_fixedReference'
        remote_file_system:
          description: Reference to a remote file system.
          title: FixedReferenceNoResourceType
          allOf:
          - $ref: '#/components/schemas/_fixedReferenceNoResourceType'
    _replicaLink:
      allOf:
      - $ref: '#/components/schemas/_resourceNoName'
      - type: object
        properties:
          lag:
            description: 'Duration, in milliseconds, which represents how far behind the

              replication `target` is from the `source`.

              '
            type: integer
            format: int64
            readOnly: true
            example: 1560
          paused:
            description: 'Returns `true` if the replica link is paused.

              '
            type: boolean
            example: false
          recovery_point:
            description: 'Time when the last piece of data was replicated, measured in

              milliseconds since the UNIX epoch, and the recovery point of the

              resource.

              '
            type: integer
            format: int64
            readOnly: true
            example: 1565034592494
          status:
            description: 'Status of the replica link. Values include `replicating`, `idle`,

              and `unhealthy`.

              '
            type: string
            example: replicating
    _errorContextResponseErrors:
      type: object
      properties:
        context:
          description: 'Contains information relating to the cause of this error,

            or the name of the object that was being processed when the error was encountered.

            This may be `null` for more general errors.

            '
          type: string
        location_context:
          description: 'Contains information relating to the context in which the request was executing

            when the error occurred.

            For example, this may be the name of an array in the same fleet.

            This may be `null` for more general errors, or if no explicit `context` parameter

            was provided with the request.

            '
          title: FixedReference
          allOf:
          - $ref: '#/components/schemas/_fixedReference'
        message:
          description: A description of the error which occurred.
          type: string
          example: Resource does not exist.
    _fixedReferenceWithoutType:
      type: object
      properties:
        id:
          description: 'A globally unique, system-generated ID.

            The ID cannot be modified.

            '
          type: string
          readOnly: true
        name:
          description: 'The resource name, such as volume name, file system name,

            snapshot name, and so on.

            '
          type: string
          readOnly: true
      x-readOnly: true
    _resourceNoName:
      description: 'An ordinary (as opposed to built-in) resource that can be created or deleted

        by the user. This might be a virtual resource (e.g., a volume), or correspond

        to something in the physical environment, like a host or a server.

        '
      allOf:
      - $ref: '#/components/schemas/_timeAware'
      - type: object
        properties:
          id:
            description: A non-modifiable, globally unique ID chosen by the system.
            type: string
            readOnly: true
            example: 2a989a09-c851-4d52-9ec6-ab728b1c04db
    _fixedReference:
      allOf:
      - $ref: '#/components/schemas/_fixedReferenceWithoutType'
      - type: object
        properties:
          resource_type:
            description: 'Type of the object (full name of the endpoint).

              Valid values are the unique part of the resource''s REST endpoint.

              For example, a reference to a file system would have a

              `resource_type` of `file-systems`.

              '
            type: string
            readOnly: true
    _direction:
      type: string
      description: 'The direction of replication. Valid values are `inbound` and

        `outbound`.

        '
      readOnly: true
      x-read-only: true
  parameters:
    Member_names_plus:
      name: member_names
      in: query
      description: 'A list of member names. Member names separated by a `+` indicate that both

        members must be present in each element. Member names separated by a `,`

        indicate that at least one member must be present in each element.

        If there is not at least one resource that matches each `member_name` element,

        an error is returned.

        Single quotes are required around all strings.

        When using Try it Out in Swagger, a list of member names separated by a `+`

        must be entered in the same item cell.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Source_ids_plus:
      name: source_ids
      in: query
      description: 'A list of source IDs. Source IDs separated by a `+` indicate that both

        sources must be present in each element. Source IDs separated by a `,`

        indicate that at least one source must be present in each element.

        If there is not at least one resource that matches each `source_id` element,

        an error is returned.

        Single quotes are required around all strings.

        When using Try it Out in Swagger, a list of source IDs separated by a `+`

        must be entered in the same item cell.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Source_names_plus:
      name: source_names
      in: query
      description: 'A list of source names. Source names separated by a `+` indicate that both

        sources must be present in each element. Source names separated by a `,`

        indicate that at least one source must be present in each element.

        If there is not at least one resource that matches each `source_name` element,

        an error is returned.

        Single quotes are required around all strings.

        When using Try it Out in Swagger, a list of source names separated by a `+`

        must be entered in the same item cell.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Offset_2:
      name: offset
      in: query
      description: 'The offset of the first resource to return from a collection.

        '
      schema:
        type: integer
        format: int32
        minimum: 0
    Remote_ids:
      name: remote_ids
      in: query
      description: 'A comma-separated list of remote array IDs. If, after filtering, there is not at least one

        resource that matches each of the elements, then an error is returned. This cannot be provided

        together with the `remote_names` query parameter.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Target_ids_plus:
      name: target_ids
      in: query
      description: 'A list of target IDs. Target IDs separated by a `+` indicate that both

        targets must be present in each element. Target IDs separated by a `,`

        indicate that at least one target must be present in each element.

        If there is not at least one resource that matches each `target_id` element,

        an error is returned.

        Single quotes are required around all strings.

        When using Try it Out in Swagger, a list of target IDs separated by a `+`

        must be entered in the same item cell.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Local_file_system_ids:
      name: local_file_system_ids
      in: query
      description: 'A comma-separated list of local file system IDs. If after filtering,

        there is not at least one resource that matches each of the elements,

        then an error is returned. This cannot be provided together with the

        `local_file_system_names` query parameter.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Ids:
      name: ids
      in: query
      description: 'A comma-separated list of resource IDs.

        If after filtering, there is not at least one resource that matches

        each of the elements of `ids`, then an error is returned.

        This cannot be provided together with the `name` or `names` query parameters.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Policy_names_2:
      name: policy_names
      in: query
      description: 'A comma-separated list of policy names.

        If there is not at least one resource that matches each `policy_name` element,

        an error is returned.

        Single quotes are required around all strings.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Filter_2:
      name: filter
      in: query
      description: 'Exclude resources that don''t match the specified criteria.

        Single quotes are required around all strings inside the filters.

        '
      schema:
        type: string
    Remote_file_system_ids:
      name: remote_file_system_ids
      in: query
      description: 'A comma-separated list of remote file system IDs. If there is not at

        least one resource that matches each of the elements, then an error is

        returned. This cannot be provided together with the `remote_file_system_names`

        query parameter.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Sort:
      name: sort
      in: query
      description: 'Sort the response by the specified fields (in descending order if ''-''

        is appended to the field name).

        NOTE: If you provide a sort you will not get a `continuation_token` in

        the response.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          pattern: ^[a-z]+(_[a-z]+)*-?
          type: string
    Allow_errors:
      name: allow_errors
      in: query
      description: 'If set to `true`, the API will allow the operation to continue even if there are errors.

        Any errors will be returned in the `errors` field of the response.

        If set to `false`, the operation will fail if there are any errors.

        '
      schema:
        type: boolean
        default: false
    Policy_ids:
      name: policy_ids
      in: query
      description: 'A comma-separated list of policy IDs.

        If after filtering, there is not at least one resource that matches

        each of the elements of `policy_ids`, then an error is returned.

        This cannot be provided together with the `policy_names` query parameter.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Continuation_token:
      name: continuation_token
      in: query
      description: 'A token used to retrieve the next page of data

        with some consistency guaranteed.

        The token is a Base64 encoded value.

        Set `continuation_token` to the system-generated token taken from the `x-next-token`

        header field of the response.

        A query has reached its last page when the response does not include a token.

        Pagination requires the `limit` and `continuation_token`

        query parameters.

        '
      schema:
        type: string
    XRequestId:
      name: X-Request-ID
      in: header
      description: 'Supplied by client during request or generated by server.

        '
      schema:
        type: string
    Limit_2:
      name: limit
      in: query
      description: 'Limit the size of the response to the specified number of resources.

        A limit of 0 can be used to get the number of resources without getting

        all of the resources. It will be returned in the total_item_count field.

        If a client asks for a page size larger than the maximum number, the request

        is still valid. In that case the server just returns the maximum number of

        items, disregarding the client''s page size request. If not specified, defaults

        to 1000.

        '
      schema:
        type: integer
        format: int32
    Limit:
      name: limit
      in: query
      description: 'Limits the size of the response to the specified number of objects on each page.

        To return the total number of resources, set `limit=0`.

        The total number of resources is returned as a `total_item_count` value.

        If the page size requested is larger than the system maximum limit,

        the server returns the maximum limit, disregarding the requested page size.

        '
      schema:
        type: integer
        format: int32
        minimum: 0
      example: 10
    Member_names:
      name: member_names
      in: query
      description: 'A comma-separated list of member names.

        If there is not at least one resource that matches each `member_name` element,

        an error is returned.

        Single quotes are required around all strings.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Sort_2:
      name: sort
      in: query
      description: 'Sort the response by the specified fields (in descending order if ''-''

        is appended to the field name).

        If you provide a sort you will not get a continuation token in

        the response.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          pattern: ^[a-z]+(_[a-z]+)*-?
          type: string
    Ids_2:
      name: ids
      in: query
      description: 'A comma-separated list of resource IDs.

        If there is not at least one resource that matches each `id` element,

        an error is returned.

        Single quotes are required around all strings.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Replicate_now:
      name: replicate_now
      in: query
      description: 'If set to `true`, replicates the contents to the specified targets.

        The `replicate_now` parameters can only be `true` with the partial-replica file system links.

        '
      schema:
        type: boolean
    Local_file_system_names:
      name: local_file_system_names
      in: query
      description: 'A comma-separated list of local file system names. If there is not

        at least one resource that matches each of the elements, then an error

        is returned. This cannot be provided together with `local_file_system_ids`

        query parameter.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Policy_ids_2:
      name: policy_ids
      in: query
      description: 'A comma-separated list of policy IDs.

        If there is not at least one resource that matches each `policy_id` element,

        an error is returned.

        Single quotes are required around all strings.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Total_only:
      name: total_only
      in: query
      description: 'If set to `true`, returns the aggregate value of all items after filtering.

        Where it makes more sense, the average value is displayed instead.

        The values are displayed for each name where meaningful.

        If `total_only=true`, the `items` list will be empty.

        '
      schema:
        type: boolean
    Filter:
      name: filter
      in: query
      description: 'Narrows down the results to only the response objects

        that satisfy the filter criteria.

        '
      schema:
        type: string
    Offset:
      name: offset
      in: query
      description: 'The offset of the first resource to return from a collection.

        '
      schema:
        type: integer
        format: int32
        minimum: 0
      example: 10
    Policy_names:
      name: policy_names
      in: query
      description: 'A comma-separated list of policy names.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Context_names:
      name: context_names
      in: query
      description: 'Performs the operation on the context specified.


        If specified, the context names must be an array of size 1, and the single element

        must be the name of an array in the same fleet or the name of the fleet itself. If

        not specified, the context will default to the array that received this request.


        Other parameters provided with the request, such as names of volumes or snapshots,

        are resolved relative to the provided `context`.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Names_or_owner_names:
      name: names_or_owner_names
      in: query
      description: 'A comma-separated list of resource names.

        Either the names of the snapshots or the owning file systems.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Continuation_token_2:
      name: continuation_token
      in: query
      description: 'An opaque token used to iterate over a collection.

        The token to use on the next request is returned in the

        `continuation_token` field of the result.

        Single quotes are required around all strings.

        '
      schema:
        type: string
        x-quoted: true
      x-quoted: true
    Authorization:
      name: Authorization
      in: header
      description: 'Access token (in JWT format) required to use any API endpoint (except `/oauth2`)

        '
      schema:
        type: string
    Member_ids:
      name: member_ids
      in: query
      description: 'A comma-separated list of member IDs.

        If after filtering, there is not at least one resource that matches

        each of the elements of `member_ids`, then an error is returned.

        This cannot be provided together with the `member_names` query parameter.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Remote_names:
      name: remote_names
      in: query
      description: 'A comma-separated list of remote array names. If, after filtering, there is not at least one

        resource that matches each of the elements, then an error is returned. This cannot be provided

        together with the `remote_ids` query parameter.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Remote_file_system_names:
      name: remote_file_system_names
      in: query
      description: 'A comma-separated list of remote file system names. If there is not at

        least one resource that matches each of the elements, then an error is

        returned. This cannot be provided together with the `remote_file_system_ids`

        query parameter.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Target_names_plus:
      name: target_names
      in: query
      description: 'A list of target names. Target names separated by a `+` indicate that both

        targets must be present in each element. Target names separated by a `,`

        indicate that at least one target must be present in each element.

        If there is not at least one resource that matches each `target_name` element,

        an error is returned.

        Single quotes are required around all strings.

        When using Try it Out in Swagger, a list of target names separated by a `+`

        must be entered in the same item cell.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Member_ids_2:
      name: member_ids
      in: query
      description: 'A comma-separated list of member IDs.

        If there is not at least one resource that matches each `member_id` element,

        an error is returned.

        Single quotes are required around all strings.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Member_ids_plus:
      name: member_ids
      in: query
      description: 'A list of member IDs. Member IDs separated by a `+` indicate that both

        members must be present in each element. Member IDs separated by a `,`

        indicate that at least one member must be present in each element.

        If there is not at least one resource that matches each `member_id` element,

        an error is returned.

        Single quotes are required around all strings.

        When using Try it Out in Swagger, a list of member IDs separated by a `+`

        must be entered in the same item cell.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
        x-quoted: true
      x-quoted: true
    Cancel_in_progress_transfers:
      name: cancel_in_progress_transfers
      in: query
      description: 'This parameter must be set to `true` in order to delete

        a file system replication link (which can cancel any

        in-progress replication transfers). Setting this parameter

        to `true` is acknowledgement that any in-progress replication

        transfers on the specified links will be cancelled when

        this request is fulfilled.

        '
      schema:
        type: boolean
    Context_names_get:
      name: context_names
      in: query
      description: 'Performs the operation on the unique contexts specified.


        If specified, each context name must be the name of an array in the same fleet or

        the name of the fleet itself.


        If not specified, the context will default to the array that received this request.


        Other parameters provided with the request, such as names of volumes or snapshots,

        are resolved relative to the provided `context`.


        Enter multiple names in comma-separated format.

        For example, `name01,name02`.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
    Remote_default_exports:
      name: remote_default_exports
      in: query
      description: 'A comma-separated list of export types to be created using default access of

        the replicated filesystem. Exports will always be created to the array level

        default server. `nfs.rules` will be set to `"*(rw,no_root_squash)"`. An SMB export

        to the default server will be created with default policies. Use empty string (`""`)

        to not create these default exports. Acceptable values: `nfs`, `smb`, `nfs,smb` and `""`.

        Default is `nfs,smb`.

        '
      style: form
      explode: false
      schema:
        type: array
        items:
          type: string
      example: nfs,smb
  responses:
    Error403:
      description: FORBIDDEN
      headers:
        X-Request-ID:
          description: Supplied by client during request or generated by server.
          schema:
            type: object
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorNoContext'
    Error400:
      description: BAD REQUEST
      headers:
        X-Request-ID:
          description: Supplied by client during request or generated by server.
          schema:
            type: object
        X-RateLimit-Remaining-minute:
          description: 'The number of requests remaining for the organization in that minute.

            '
          schema:
            type: object
        X-RateLimit-Remaining-second:
          description: 'The number of requests remaining for the organization in that second.

            '
          schema:
            type: object
        X-RateLimit-Limit-minute:
          description: The number of requests available per minute.
          schema:
            type: object
        X-RateLimit-Limit-second:
          description: The number of requests available per second.
          schema:
            type: object
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error429:
      description: TOO MANY REQUESTS
      headers:
        X-Request-ID:
          description: Supplied by client during request or generated by server.
          schema:
            type: object
        X-RateLimit-Remaining-minute:
          description: 'The number of requests remaining for the organization in that minute.

            '
          schema:
            type: object
        X-RateLimit-Remaining-second:
          description: 'The number of requests remaining for the organization in that second.

            '
          schema:
            type: object
        X-RateLimit-Limit-minute:
          description: The number of requests available per minute.
          schema:
            type: object
        X-RateLimit-Limit-second:
          description: The number of requests available per second.
          schema:
            type: object
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorNoContext'
    Error500:
      description: INTERNAL SERVER ERROR
      headers:
        X-Request-ID:
          description: Supplied by client during request or generated by server.
          schema:
            type: object
        X-RateLimit-Remaining-minute:
          description: 'The number of requests remaining for the organization in that minute.

            '
          schema:
            type: object
        X-RateLimit-Remaining-second:
          description: 'The number of requests remaining for the organization in that second.

            '
          schema:
            type: object
        X-RateLimit-Limit-minute:
          description: The number of requests available per minute.
          schema:
            type: object
        X-RateLimit-Limit-second:
          description: The number of requests available per second.
          schema:
            type: object
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error404:
      description: NOT FOUND
      headers:
        X-Request-ID:
          description: Supplied by client during request or generated by server.
          schema:
            type: object
        X-RateLimit-Remaining-minute:
          description: 'The number of requests remaining for the organization in that minute.

            '
          schema:
            type: object
        X-RateLimit-Remaining-second:
          description: 'The number of requests remaining for the organization in that second.

            '
          schema:
            type: object
        X-RateLimit-Limit-minute:
          description: The number of requests available per minute.
          schema:
            type: object
        X-RateLimit-Limit-second:
          description: The number of requests available per second.
          schema:
            type: object
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'