openapi: 3.0.1 info: title: FlashArray REST Active Directory Realm Connections 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: Realm Connections description: 'Realm connections enable replication services between different realms in a connected array cluster. ' paths: /api/2.52/realm-connections: get: tags: - Realm Connections summary: Pure Storage List Realm Connections. description: 'Displays a list of configured realm connections. ' parameters: - $ref: '#/components/parameters/Authorization' - $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_without_names' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Local_realm_ids' - $ref: '#/components/parameters/Local_realm_names' - $ref: '#/components/parameters/Offset' - $ref: '#/components/parameters/Remote_realm_ids' - $ref: '#/components/parameters/Remote_realm_names' - $ref: '#/components/parameters/Sort' - $ref: '#/components/parameters/Total_item_count' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RealmConnectionsGetResponse' '207': description: 'Indicates partial success. Some resources were returned, but errors may have prevented other resources from being returned. ' content: application/json: schema: $ref: '#/components/schemas/RealmConnectionsGetResponse' post: tags: - Realm Connections summary: Pure Storage Create Realm Connection. description: 'Creates a new connection between two realms. ' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Context_names' - $ref: '#/components/parameters/Local_realm_ids' - $ref: '#/components/parameters/Local_realm_names' - $ref: '#/components/parameters/Remote_realm_ids' - $ref: '#/components/parameters/Remote_realm_names' requestBody: content: application/json: schema: $ref: '#/components/schemas/RealmConnectionWithKey' required: true x-codegen-request-body-name: connection responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RealmConnectionsResponse' x-codegen-request-body-name: connection delete: tags: - Realm Connections summary: Pure Storage Delete Realm Connections. description: 'Deletes connections between realms. ' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Context_names' - $ref: '#/components/parameters/Ids_without_names' - $ref: '#/components/parameters/Local_realm_ids' - $ref: '#/components/parameters/Local_realm_names' - $ref: '#/components/parameters/Remote_realm_ids' - $ref: '#/components/parameters/Remote_realm_names' responses: '200': description: OK content: {} patch: tags: - Realm Connections summary: Pure Storage Modify Realm Connections. description: 'Modifies the connection type between realms. ' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Context_names' - $ref: '#/components/parameters/Ids_without_names' - $ref: '#/components/parameters/Local_realm_ids' - $ref: '#/components/parameters/Local_realm_names' - $ref: '#/components/parameters/Remote_realm_ids' - $ref: '#/components/parameters/Remote_realm_names' requestBody: content: application/json: schema: $ref: '#/components/schemas/RealmConnectionWithKey' required: true x-codegen-request-body-name: connection responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RealmConnectionsResponse' x-codegen-request-body-name: connection /api/2.52/realm-connections/connection-keys: get: tags: - Realm Connections summary: Pure Storage Get Realm Connection Key Information description: 'Displays information about existing realm connection keys. Secret keys are not displayed, as they are only available at the time of key creation. ' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Allow_errors' - $ref: '#/components/parameters/Context_names' - $ref: '#/components/parameters/Continuation_token' - $ref: '#/components/parameters/Filter' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Offset' - $ref: '#/components/parameters/Realm_ids' - $ref: '#/components/parameters/Realm_names' - $ref: '#/components/parameters/Sort' - $ref: '#/components/parameters/Total_item_count' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RealmConnectionKeyGetResponse' post: tags: - Realm Connections summary: Pure Storage Create Realm Connection Key description: 'Creates a new one-time connection key to allow establishing a connection to the specified realm. The key is valid until a successful connection is established or its expiration time is reached. Note that this is the only time the connection key is displayed; it cannot be retrieved subsequently. ' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Context_names' - $ref: '#/components/parameters/Realm_ids' - $ref: '#/components/parameters/Realm_names' requestBody: content: application/json: schema: $ref: '#/components/schemas/RealmConnectionKeyPost' required: true x-codegen-request-body-name: connection_key responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RealmConnectionKeyPostResponse' x-codegen-request-body-name: connection_key delete: tags: - Realm Connections summary: Pure Storage Delete Realm Connection Keys description: 'Deletes all connection keys for a given realm. Note that every realm connection key is a one-time key and is deleted automatically upon a successful connection or once it expires. ' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Context_names' - $ref: '#/components/parameters/Realm_ids' - $ref: '#/components/parameters/Realm_names' responses: '200': description: OK content: {} /api/2.26/realm-connections: get: tags: - Realm Connections summary: Pure Storage GET Realm-connections description: List realm connections. parameters: - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Continuation_token' - $ref: '#/components/parameters/Filter' - $ref: '#/components/parameters/Ids' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Local_realm_ids_2' - $ref: '#/components/parameters/Local_realm_names_2' - $ref: '#/components/parameters/Offset_2' - $ref: '#/components/parameters/Remote_realm_ids_2' - $ref: '#/components/parameters/Remote_realm_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 content: application/json: schema: $ref: '#/components/schemas/RealmConnectionGetResponse' post: tags: - Realm Connections summary: Pure Storage POST Realm-connections description: Create a realm connection. parameters: - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Local_realm_ids_2' - $ref: '#/components/parameters/Local_realm_names_2' - $ref: '#/components/parameters/Remote_realm_ids_2' - $ref: '#/components/parameters/Remote_realm_names_2' requestBody: content: application/json: schema: $ref: '#/components/schemas/RealmConnectionPost' required: true 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/RealmConnectionResponse' delete: tags: - Realm Connections summary: Pure Storage DELETE Realm-connections description: Delete realm connection. parameters: - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Local_realm_ids_2' - $ref: '#/components/parameters/Local_realm_names_2' - $ref: '#/components/parameters/Remote_realm_ids_2' - $ref: '#/components/parameters/Remote_realm_names_2' 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/realm-connections/connection-key: get: tags: - Realm Connections summary: Pure Storage GET Realm-connections/connection-key description: List realm connection keys. parameters: - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Continuation_token' - $ref: '#/components/parameters/Filter' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Offset_2' - $ref: '#/components/parameters/Realm_ids_2' - $ref: '#/components/parameters/Realm_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 content: application/json: schema: $ref: '#/components/schemas/RealmConnectionKeyGetResponse_2' post: tags: - Realm Connections summary: Pure Storage POST Realm-connections/connection-key description: Create a realm connection key. parameters: - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Realm_ids_2' - $ref: '#/components/parameters/Realm_names_2' 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/RealmConnectionKeyResponse_2' delete: tags: - Realm Connections summary: Pure Storage DELETE Realm-connections/connection-key description: Delete a realm connection key. parameters: - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Realm_ids_2' - $ref: '#/components/parameters/Realm_names_2' responses: '200': description: OK headers: X-Request-ID: description: Supplied by client during request or generated by server. schema: type: string content: {} components: schemas: _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' _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 x-aliases: - _referenceWithoutType _builtInRelationship: type: object properties: id: description: 'A non-modifiable, globally unique ID chosen by the system. ' type: string readOnly: true _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 _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: FixedReferenceWithType allOf: - $ref: '#/components/schemas/_fixedReferenceWithType' message: description: A description of the error which occurred. type: string example: Resource does not exist. x-aliases: - _errorContextResponseErrors _referenceWithType: allOf: - $ref: '#/components/schemas/_reference' - type: object properties: 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 x-aliases: - _reference RealmConnectionKeyResponse_2: type: object properties: items: type: array items: $ref: '#/components/schemas/RealmConnectionKey_2' RealmConnectionKeyGetResponse: allOf: - $ref: '#/components/schemas/PageInfo' - $ref: '#/components/schemas/_errorContextResponse' - $ref: '#/components/schemas/RealmConnectionKeyResponse' RealmConnectionKey: allOf: - $ref: '#/components/schemas/_context' - type: object properties: connection_key: description: 'Specifies the unique string token used to create or update a realm connection. The key is only visible when created. The response of the POST operation and any subsequent GET requests hide the key as ****. ' type: string readOnly: true created: description: 'The creation time in milliseconds since the UNIX epoch. ' type: integer format: int64 example: 1706850977000 expires: description: 'The expiration time in milliseconds since the UNIX epoch. ' type: integer format: int64 example: 1706850977000 realm: description: 'The realm to which the connection key is associated. ' title: ReferenceWithType allOf: - $ref: '#/components/schemas/_referenceWithType' type: description: 'Specifies the type of realm connection that a key can create. Values include async-replication and sync-replication. A sync-replication key can also be used to create an async-replication connection. ' type: string _fixedReferenceWithType: allOf: - $ref: '#/components/schemas/_fixedReference' - 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 x-aliases: - _fixedReference RealmConnectionKeyResponse: type: object properties: items: description: A list of realm connection key objects. type: array items: $ref: '#/components/schemas/RealmConnectionKey' RealmConnectionKeyPost: type: object properties: type: description: 'Specifies the type of realm connection that a key can create. Values include async-replication and sync-replication. A sync-replication key can also be used to create an async-replication connection. ' type: string RealmConnection_2: allOf: - $ref: '#/components/schemas/_builtInRelationship' - type: object properties: local_realm: description: Realm on the local cluster connected to the remote realm. title: FixedReference allOf: - $ref: '#/components/schemas/_fixedReference_2' readOnly: true remote_realm: description: Realm on the remote cluster connected to the local realm. title: FixedReference allOf: - $ref: '#/components/schemas/_fixedReference_2' readOnly: true status: description: 'Status of the realm connection. Values include `CONNECTING`, `CONNECTED`, `DISCONNECTED` and `UNREACHABLE`. ' type: string readOnly: true RealmConnectionsGetResponse: allOf: - $ref: '#/components/schemas/PageInfo' - $ref: '#/components/schemas/_errorContextResponse' - $ref: '#/components/schemas/RealmConnectionsResponse' RealmConnectionKeyPostResponse: type: object properties: items: description: A list of realm connection keys. type: array items: $ref: '#/components/schemas/RealmConnectionKey' RealmConnectionWithKey: allOf: - $ref: '#/components/schemas/RealmConnection' - type: object properties: connection_key: description: 'Specifies the unique string token used to create or update a realm connection to the remote realm associated with the key. On update, the key is required only when changing the connection type from async-replication to sync-replication. ' type: string RealmConnectionKeyGetResponse_2: allOf: - $ref: '#/components/schemas/PageInfo_2' - $ref: '#/components/schemas/RealmConnectionKeyResponse_2' _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: FixedReferenceWithType allOf: - $ref: '#/components/schemas/_fixedReferenceWithType' RealmConnectionResponse: type: object properties: items: type: array items: $ref: '#/components/schemas/RealmConnection_2' RealmConnectionPost: allOf: - $ref: '#/components/schemas/RealmConnection_2' - type: object properties: connection_key: description: 'The connection key for the remote realm. Settable on POST only. ' type: string RealmConnectionsResponse: type: object properties: items: description: A list of realm connection objects. type: array items: $ref: '#/components/schemas/RealmConnection' _fixedReference_2: 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 RealmConnection: allOf: - $ref: '#/components/schemas/_context' - type: object properties: id: description: The ID of a realm connection object. type: string readOnly: true local_realm: description: 'The local realm side of a connection. ' readOnly: true title: ReferenceWithType allOf: - $ref: '#/components/schemas/_referenceWithType' remote_realm: description: 'The remote realm side of a connection. ' readOnly: true title: ReferenceWithType allOf: - $ref: '#/components/schemas/_referenceWithType' status: description: 'The connection status. Values include connected, unreachable, and degraded. The connected status means that the connection is alive and data is replicating. The unreachable status indicates that the remote realm is not found on any array in the cluster. The degraded status indicates that the array connection was downgraded to the async-replication type while the realm connection''s type is sync-replication. In that case, the realm can use the async replication feature but cannot use sync-replication features. ' type: string readOnly: true type: description: 'Specifies the type of the realm connection. Values include async-replication and sync-replication. ' type: string 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 total_item_count: description: Total number of items after applying `filter` params. type: integer format: int32 _fixedReference: 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 x-aliases: - _fixedReferenceWithoutType RealmConnectionKey_2: type: object properties: connection_key: description: 'Connection-key, used to establish connection between two realms After creation, listing will only show ****. ' type: string readOnly: true example: '"6207d123-d123-0b5c-5fa1-95fabc5c7123" or "****"' created: description: Creation time in milliseconds since UNIX epoch. type: integer format: int64 example: 1742221735 readOnly: true expires: description: Expiration time in milliseconds since UNIX epoch. type: integer format: int64 example: 1742228935 readOnly: true realm: description: Realm for which the key was generated. title: FixedReference allOf: - $ref: '#/components/schemas/_fixedReference_2' x-readOnly: true RealmConnectionGetResponse: allOf: - $ref: '#/components/schemas/PageInfo_2' - $ref: '#/components/schemas/RealmConnectionResponse' 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 more_items_remaining: description: 'Returns a value of `true` if subsequent items can be retrieved. ' type: boolean example: false total_item_count: description: 'The total number of records after applying all filter query parameters. The `total_item_count` will be calculated if and only if the corresponding query parameter `total_item_count` is set to `true`. If this query parameter is not set or set to `false`, a value of `null` will be returned. ' type: integer format: int32 parameters: 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 starting position based on the results of the query in relation to the full set of response objects returned. ' schema: type: integer format: int32 minimum: 0 example: 10 Realm_ids: name: realm_ids in: query description: 'Performs the operation on the specified unique resource IDs. Enter multiple resource IDs in comma-separated format. The realm_ids and realm_names parameters cannot be set together. ' style: form explode: false schema: type: array items: type: string Realm_names_2: name: realm_names in: query description: 'A comma-separated list of realm 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 `realm_ids` query parameter. ' style: form explode: false schema: type: array items: 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 Remote_realm_names: name: remote_realm_names in: query description: 'Performs the operation on the specified unique resource IDs. Enter multiple resource IDs in comma-separated format. The remote_realm_ids and remote_realm_names parameters cannot be set together. ' style: form explode: false schema: type: array items: type: string Local_realm_ids_2: name: local_realm_ids in: query description: 'A comma-separated list of local realm 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_realm_names` query parameter. ' style: form explode: false schema: type: array items: type: string Local_realm_names_2: name: local_realm_names in: query description: 'A comma-separated list of local realm 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_realm_ids` 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 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 example: 10 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 XRequestId: name: X-Request-ID in: header description: 'Supplied by client during request or generated by server. ' schema: type: string 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 Authorization: name: Authorization in: header description: 'Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`) ' schema: type: string Remote_realm_ids_2: name: remote_realm_ids in: query description: 'A comma-separated list of remote realm 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_realm_names` query parameter. ' style: form explode: false schema: type: array items: type: string 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_realm_names_2: name: remote_realm_names in: query description: 'A comma-separated list of remote realm 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 `remote_realm_ids` query parameter. ' style: form explode: false schema: type: array items: type: string Local_realm_names: name: local_realm_names in: query description: 'Performs the operation on the specified unique resource names. Enter multiple resource names in comma-separated format. The local_realm_names and local_realm_ids parameters cannot be set together. ' style: form explode: false schema: type: array items: type: string Sort_2: 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 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 Ids_without_names: name: ids in: query description: 'Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. ' style: form explode: false schema: type: array items: type: string Total_item_count: name: total_item_count in: query description: 'If set to `true`, the `total_item_count` matching the specified query parameters is calculated and returned in the response. If set to `false`, the `total_item_count` is `null` in the response. This may speed up queries where the `total_item_count` is large. If not specified, defaults to `false`. ' schema: type: boolean Remote_realm_ids: name: remote_realm_ids in: query description: 'Performs the operation on the specified unique resource IDs. Enter multiple resource IDs in comma-separated format. The remote_realm_ids and remote_realm_names parameters cannot be set together. ' style: form explode: false schema: type: array items: type: string Realm_names: name: realm_names in: query description: 'Performs the operation on the specified unique resource names. Enter multiple resource names in comma-separated format. The realm_names and realm_ids parameters cannot be set together. ' style: form explode: false schema: type: array items: type: string Sort: name: sort in: query description: "Sorts the response objects by the specified fields. Sorting can be applied to any field name\n in the response, in ascending order by default, or in descending order by prefixing the\n field name with a minus sign (-). Multiple fields can be specified as a comma-separated\n list (e.g., sort volumes by size descending, then by name ascending). If sort is provided,\n the response will not include a continuation_token.\n" style: form explode: false schema: type: array items: pattern: ^[a-z]+(_[a-z]+)*-? type: string Realm_ids_2: name: realm_ids in: query description: 'A comma-separated list of realm 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 `realm_names` query parameter. ' style: form explode: false schema: type: array items: type: string Local_realm_ids: name: local_realm_ids in: query description: 'Performs the operation on the specified unique resource IDs. Enter multiple resource IDs in comma-separated format. The local_realm_ids and local_realm_names parameters cannot be set together. ' style: form explode: false schema: type: array items: type: string