Microsoft Azure ComputeNodes API

swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector ComputeNodes API
schemes:
- https
tags:
- name: ComputeNodes
paths:
  /pools/{poolId}/removenodes:
    post:
      tags:
      - ComputeNodes
      operationId: microsoftAzurePoolRemovenodes
      x-ms-examples:
        Pool remove nodes:
          $ref: ./examples/PoolRemoveNodes.json
      summary: Microsoft Azure Removes Compute Nodes From The Specified Pool
      description: This operation can only run when the allocation state of the Pool is steady. When this operation runs, the allocation state changes from steady to resizing. Each request may remove up to 100 nodes.
      x-ms-request-id: request-id
      parameters:
      - name: poolId
        in: path
        required: true
        type: string
        description: The ID of the Pool from which you want to remove Compute Nodes.
      - name: nodeRemoveParameter
        in: body
        required: true
        schema:
          $ref: '#/definitions/NodeRemoveParameter'
        description: The parameters for the request.
      - name: timeout
        in: query
        required: false
        type: integer
        format: int32
        default: 30
        description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds.
        x-ms-parameter-grouping:
          postfix: Options
      - name: client-request-id
        in: header
        required: false
        type: string
        format: uuid
        description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
        x-ms-parameter-grouping:
          postfix: Options
        x-ms-client-request-id: true
      - name: return-client-request-id
        default: false
        in: header
        required: false
        type: boolean
        description: Whether the server should return the client-request-id in the response.
        x-ms-parameter-grouping:
          postfix: Options
      - name: ocp-date
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.
        x-ms-parameter-grouping:
          postfix: Options
      - name: If-Match
        in: header
        required: false
        type: string
        description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the service exactly matches the value specified by the client.
        x-ms-parameter-grouping:
          postfix: Options
      - name: If-None-Match
        in: header
        required: false
        type: string
        description: An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the service does not match the value specified by the client.
        x-ms-parameter-grouping:
          postfix: Options
      - name: If-Modified-Since
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has been modified since the specified time.
        x-ms-parameter-grouping:
          postfix: Options
      - name: If-Unmodified-Since
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has not been modified since the specified time.
        x-ms-parameter-grouping:
          postfix: Options
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '202':
          headers:
            client-request-id:
              description: The client-request-id provided by the client during the request. This will be returned only if the return-client-request-id parameter was set to true.
              type: string
              format: uuid
            request-id:
              description: A unique identifier for the request that was made to the Batch service. If a request is consistently failing and you have verified that the request is properly formulated, you may use this value to report the error to Microsoft. In your report, include the value of this request ID, the approximate time that the request was made, the Batch Account against which the request was made, and the region that Account resides in.
              type: string
              format: uuid
            ETag:
              description: The ETag HTTP response header. This is an opaque string. You can use it to detect whether the resource has changed between requests. In particular, you can pass the ETag to one of the If-Modified-Since, If-Unmodified-Since, If-Match or If-None-Match headers.
              type: string
            Last-Modified:
              description: The time at which the resource was last modified.
              type: string
              format: date-time-rfc1123
            DataServiceId:
              description: The OData ID of the resource to which the request applied.
              type: string
          description: The request to the Batch service was successful.
        default:
          description: The error from the Batch service.
          schema:
            $ref: '#/definitions/BatchError'
  /pools/{poolId}/nodes/{nodeId}/users:
    post:
      tags:
      - ComputeNodes
      operationId: microsoftAzureComputenodeAdduser
      x-ms-examples:
        Node add user:
          $ref: ./examples/NodeAddUser.json
      summary: Microsoft Azure Adds A User Account To The Specified Compute Node
      description: You can add a user Account to a Compute Node only when it is in the idle or running state.
      x-ms-request-id: request-id
      parameters:
      - name: poolId
        in: path
        required: true
        type: string
        description: The ID of the Pool that contains the Compute Node.
      - name: nodeId
        in: path
        required: true
        type: string
        description: The ID of the machine on which you want to create a user Account.
      - name: user
        in: body
        description: The user Account to be created.
        required: true
        schema:
          $ref: '#/definitions/ComputeNodeUser'
      - name: timeout
        in: query
        required: false
        type: integer
        format: int32
        default: 30
        description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds.
        x-ms-parameter-grouping:
          postfix: Options
      - name: client-request-id
        in: header
        required: false
        type: string
        format: uuid
        description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
        x-ms-parameter-grouping:
          postfix: Options
        x-ms-client-request-id: true
      - name: return-client-request-id
        default: false
        in: header
        required: false
        type: boolean
        description: Whether the server should return the client-request-id in the response.
        x-ms-parameter-grouping:
          postfix: Options
      - name: ocp-date
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.
        x-ms-parameter-grouping:
          postfix: Options
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '201':
          headers:
            client-request-id:
              description: The client-request-id provided by the client during the request. This will be returned only if the return-client-request-id parameter was set to true.
              type: string
              format: uuid
            request-id:
              description: A unique identifier for the request that was made to the Batch service. If a request is consistently failing and you have verified that the request is properly formulated, you may use this value to report the error to Microsoft. In your report, include the value of this request ID, the approximate time that the request was made, the Batch Account against which the request was made, and the region that Account resides in.
              type: string
              format: uuid
            ETag:
              description: The ETag HTTP response header. This is an opaque string. You can use it to detect whether the resource has changed between requests. In particular, you can pass the ETag to one of the If-Modified-Since, If-Unmodified-Since, If-Match or If-None-Match headers.
              type: string
            Last-Modified:
              description: The time at which the resource was last modified.
              type: string
              format: date-time-rfc1123
            DataServiceId:
              description: The OData ID of the resource to which the request applied.
              type: string
          description: The request to the Batch service was successful.
        default:
          description: The error from the Batch service.
          schema:
            $ref: '#/definitions/BatchError'
  /pools/{poolId}/nodes/{nodeId}/users/{userName}:
    delete:
      tags:
      - ComputeNodes
      operationId: microsoftAzureComputenodeDeleteuser
      x-ms-examples:
        Node delete user:
          $ref: ./examples/NodeDeleteUser.json
      summary: Microsoft Azure Deletes A User Account From The Specified Compute Node
      description: You can delete a user Account to a Compute Node only when it is in the idle or running state.
      x-ms-request-id: request-id
      parameters:
      - name: poolId
        in: path
        required: true
        type: string
        description: The ID of the Pool that contains the Compute Node.
      - name: nodeId
        in: path
        required: true
        type: string
        description: The ID of the machine on which you want to delete a user Account.
      - name: userName
        in: path
        required: true
        type: string
        description: The name of the user Account to delete.
      - name: timeout
        in: query
        required: false
        type: integer
        format: int32
        default: 30
        description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds.
        x-ms-parameter-grouping:
          postfix: Options
      - name: client-request-id
        in: header
        required: false
        type: string
        format: uuid
        description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
        x-ms-parameter-grouping:
          postfix: Options
        x-ms-client-request-id: true
      - name: return-client-request-id
        default: false
        in: header
        required: false
        type: boolean
        description: Whether the server should return the client-request-id in the response.
        x-ms-parameter-grouping:
          postfix: Options
      - name: ocp-date
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.
        x-ms-parameter-grouping:
          postfix: Options
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          headers:
            client-request-id:
              description: The client-request-id provided by the client during the request. This will be returned only if the return-client-request-id parameter was set to true.
              type: string
            request-id:
              description: A unique identifier for the request that was made to the Batch service. If a request is consistently failing and you have verified that the request is properly formulated, you may use this value to report the error to Microsoft. In your report, include the value of this request ID, the approximate time that the request was made, the Batch Account against which the request was made, and the region that Account resides in.
              type: string
          description: The request to the Batch service was successful.
        default:
          description: The error from the Batch service.
          schema:
            $ref: '#/definitions/BatchError'
    put:
      tags:
      - ComputeNodes
      operationId: microsoftAzureComputenodeUpdateuser
      x-ms-examples:
        Node update user:
          $ref: ./examples/NodeUpdateUser.json
      summary: Microsoft Azure Updates The Password And Expiration Time Of A User Account On The Specified Compute Node
      description: This operation replaces of all the updatable properties of the Account. For example, if the expiryTime element is not specified, the current value is replaced with the default value, not left unmodified. You can update a user Account on a Compute Node only when it is in the idle or running state.
      x-ms-request-id: request-id
      parameters:
      - name: poolId
        in: path
        required: true
        type: string
        description: The ID of the Pool that contains the Compute Node.
      - name: nodeId
        in: path
        required: true
        type: string
        description: The ID of the machine on which you want to update a user Account.
      - name: userName
        in: path
        required: true
        type: string
        description: The name of the user Account to update.
      - name: nodeUpdateUserParameter
        in: body
        required: true
        schema:
          $ref: '#/definitions/NodeUpdateUserParameter'
        description: The parameters for the request.
      - name: timeout
        in: query
        required: false
        type: integer
        format: int32
        default: 30
        description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds.
        x-ms-parameter-grouping:
          postfix: Options
      - name: client-request-id
        in: header
        required: false
        type: string
        format: uuid
        description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
        x-ms-parameter-grouping:
          postfix: Options
        x-ms-client-request-id: true
      - name: return-client-request-id
        default: false
        in: header
        required: false
        type: boolean
        description: Whether the server should return the client-request-id in the response.
        x-ms-parameter-grouping:
          postfix: Options
      - name: ocp-date
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.
        x-ms-parameter-grouping:
          postfix: Options
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          headers:
            client-request-id:
              description: The client-request-id provided by the client during the request. This will be returned only if the return-client-request-id parameter was set to true.
              type: string
              format: uuid
            request-id:
              description: A unique identifier for the request that was made to the Batch service. If a request is consistently failing and you have verified that the request is properly formulated, you may use this value to report the error to Microsoft. In your report, include the value of this request ID, the approximate time that the request was made, the Batch Account against which the request was made, and the region that Account resides in.
              type: string
              format: uuid
            ETag:
              description: The ETag HTTP response header. This is an opaque string. You can use it to detect whether the resource has changed between requests. In particular, you can pass the ETag to one of the If-Modified-Since, If-Unmodified-Since, If-Match or If-None-Match headers.
              type: string
            Last-Modified:
              description: The time at which the resource was last modified.
              type: string
              format: date-time-rfc1123
            DataServiceId:
              description: The OData ID of the resource to which the request applied.
              type: string
          description: The request to the Batch service was successful.
        default:
          description: The error from the Batch service.
          schema:
            $ref: '#/definitions/BatchError'
  /pools/{poolId}/nodes/{nodeId}:
    get:
      tags:
      - ComputeNodes
      operationId: microsoftAzureComputenodeGet
      x-ms-examples:
        Node get:
          $ref: ./examples/NodeGet_Basic.json
      summary: Microsoft Azure Gets Information About The Specified Compute Node
      x-ms-request-id: request-id
      parameters:
      - name: poolId
        in: path
        required: true
        type: string
        description: The ID of the Pool that contains the Compute Node.
      - name: nodeId
        in: path
        required: true
        type: string
        description: The ID of the Compute Node that you want to get information about.
      - name: $select
        in: query
        required: false
        type: string
        description: An OData $select clause.
        x-ms-parameter-grouping:
          postfix: Options
      - name: timeout
        in: query
        required: false
        type: integer
        format: int32
        default: 30
        description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds.
        x-ms-parameter-grouping:
          postfix: Options
      - name: client-request-id
        in: header
        required: false
        type: string
        format: uuid
        description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
        x-ms-parameter-grouping:
          postfix: Options
        x-ms-client-request-id: true
      - name: return-client-request-id
        default: false
        in: header
        required: false
        type: boolean
        description: Whether the server should return the client-request-id in the response.
        x-ms-parameter-grouping:
          postfix: Options
      - name: ocp-date
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.
        x-ms-parameter-grouping:
          postfix: Options
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          headers:
            client-request-id:
              description: The client-request-id provided by the client during the request. This will be returned only if the return-client-request-id parameter was set to true.
              type: string
              format: uuid
            request-id:
              description: A unique identifier for the request that was made to the Batch service. If a request is consistently failing and you have verified that the request is properly formulated, you may use this value to report the error to Microsoft. In your report, include the value of this request ID, the approximate time that the request was made, the Batch Account against which the request was made, and the region that Account resides in.
              type: string
              format: uuid
            ETag:
              description: The ETag HTTP response header. This is an opaque string. You can use it to detect whether the resource has changed between requests. In particular, you can pass the ETag to one of the If-Modified-Since, If-Unmodified-Since, If-Match or If-None-Match headers.
              type: string
            Last-Modified:
              description: The time at which the resource was last modified.
              type: string
              format: date-time-rfc1123
          description: A response containing the Compute Node.
          schema:
            $ref: '#/definitions/ComputeNode'
        default:
          description: The error from the Batch service.
          schema:
            $ref: '#/definitions/BatchError'
      description: Needs a more full description created.
  /pools/{poolId}/nodes/{nodeId}/reboot:
    post:
      tags:
      - ComputeNodes
      operationId: microsoftAzureComputenodeReboot
      x-ms-examples:
        Node reboot:
          $ref: ./examples/NodeReboot.json
      summary: Microsoft Azure Restarts The Specified Compute Node
      description: You can restart a Compute Node only if it is in an idle or running state.
      x-ms-request-id: request-id
      parameters:
      - name: poolId
        in: path
        required: true
        type: string
        description: The ID of the Pool that contains the Compute Node.
      - name: nodeId
        in: path
        required: true
        type: string
        description: The ID of the Compute Node that you want to restart.
      - name: nodeRebootParameter
        in: body
        required: false
        schema:
          $ref: '#/definitions/NodeRebootParameter'
        description: The parameters for the request.
      - name: timeout
        in: query
        required: false
        type: integer
        format: int32
        default: 30
        description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds.
        x-ms-parameter-grouping:
          postfix: Options
      - name: client-request-id
        in: header
        required: false
        type: string
        format: uuid
        description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
        x-ms-parameter-grouping:
          postfix: Options
        x-ms-client-request-id: true
      - name: return-client-request-id
        default: false
        in: header
        required: false
        type: boolean
        description: Whether the server should return the client-request-id in the response.
        x-ms-parameter-grouping:
          postfix: Options
      - name: ocp-date
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.
        x-ms-parameter-grouping:
          postfix: Options
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '202':
          headers:
            client-request-id:
              description: The client-request-id provided by the client during the request. This will be returned only if the return-client-request-id parameter was set to true.
              type: string
              format: uuid
            request-id:
              description: A unique identifier for the request that was made to the Batch service. If a request is consistently failing and you have verified that the request is properly formulated, you may use this value to report the error to Microsoft. In your report, include the value of this request ID, the approximate time that the request was made, the Batch Account against which the request was made, and the region that Account resides in.
              type: string
              format: uuid
            ETag:
              description: The ETag HTTP response header. This is an opaque string. You can use it to detect whether the resource has changed between requests. In particular, you can pass the ETag to one of the If-Modified-Since, If-Unmodified-Since, If-Match or If-None-Match headers.
              type: string
            Last-Modified:
              description: The time at which the resource was last modified.
              type: string
              format: date-time-rfc1123
            DataServiceId:
              description: The OData ID of the resource to which the request applied.
              type: string
          description: The request to the Batch service was successful.
        default:
          description: The error from the Batch service.
          schema:
            $ref: '#/definitions/BatchError'
  /pools/{poolId}/nodes/{nodeId}/reimage:
    post:
      tags:
      - ComputeNodes
      operationId: microsoftAzureComputenodeReimage
      x-ms-examples:
        Node reimage:
          $ref: ./examples/NodeReimage.json
      summary: Microsoft Azure Reinstalls The Operating System On The Specified Compute Node
      description: You can reinstall the operating system on a Compute Node only if it is in an idle or running state. This API can be invoked only on Pools created with the cloud service configuration property.
      x-ms-request-id: request-id
      parameters:
      - name: poolId
        in: path
        required: true
        type: string
        description: The ID of the Pool that contains the Compute Node.
      - name: nodeId
        in: path
        required: true
        type: string
        description: The ID of the Compute Node that you want to restart.
      - name: nodeReimageParameter
        in: body
        required: false
        schema:
          $ref: '#/definitions/NodeReimageParameter'
        description: The parameters for the request.
      - name: timeout
        in: query
        required: false
        type: integer
        format: int32
        default: 30
        description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds.
        x-ms-parameter-grouping:
          postfix: Options
      - name: client-request-id
        in: header
        required: false
        type: string
        format: uuid
        description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
        x-ms-parameter-grouping:
          postfix: Options
        x-ms-client-request-id: true
      - name: return-client-request-id
        default: false
        in: header
        required: false
        type: boolean
        description: Whether the server should return the client-request-id in the response.
        x-ms-parameter-grouping:
          postfix: Options
      - name: ocp-date
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.
        x-ms-parameter-grouping:
          postfix: Options
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '202':
          headers:
            client-request-id:
              description: The client-request-id provided by the client during the request. This will be returned only if the return-client-request-id parameter was set to true.
              type: string
              format: uuid
            request-id:
              description: A unique identifier for the request that was made to the Batch service. If a request is consistently failing and you have verified that the request is properly formulated, you may use this value to report the error to Microsoft. In your report, include the value of this request ID, the approximate time that the request was made, the Batch Account against which the request was made, and the region that Account resides in.
              type: string
              format: uuid
            ETag:
              description: The ETag HTTP response header. This is an opaque string. You can use it to detect whether the resource has changed between requests. In particular, you can pass the ETag to one of the If-Modified-Since, If-Unmodified-Since, If-Match or If-None-Match headers.
              type: string
            Last-Modified:
              description: The time at which the resource was last modified.
              type: string
              format: date-time-rfc1123
            DataServiceId:
              description: The OData ID of the resource to which the request applied.
              type: string
          description: The request to the Batch service was successful.
        default:
          description: The error from the Batch service.
          schema:
            $ref: '#/definitions/BatchError'
  /pools/{poolId}/nodes/{nodeId}/disablescheduling:
    post:
      tags:
      - ComputeNodes
      operationId: microsoftAzureComputenodeDisablescheduling
      x-ms-examples:
        Node disable scheduling:
          $ref: ./examples/NodeDisableScheduling.json
      summary: Microsoft Azure Disables Task Scheduling On The Specified Compute Node
      description: You can disable Task scheduling on a Compute Node only if its current scheduling state is enabled.
      x-ms-request-id: request-id
      parameters:
      - name: poolId
        in: path
        required: true
        type: string
        description: The ID of the Pool that contains the Compute Node.
      - name: nodeId
        in: path
        required: true
        type: string
        description: The ID of the Compute Node on which you want to disable Task scheduling.
      - name: nodeDisableSchedulingParameter
        in: body
        required: false
        schema:
          $ref: '#/definitions/NodeDisableSchedulingParameter'
        description: The parameters for the request.
      - name: timeout
        in: query
        required: false
        type: integer
        format: int32
        default: 30
        description: The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds.
        x-ms-parameter-grouping:
          postfix: Options
      - name: client-request-id
        in: header
        required: false
        type: string
        format: uuid
        description: The caller-generated request identity, in the form of a GUID with no decoration such as curly braces, e.g. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
        x-ms-parameter-grouping:
          postfix: Options
        x-ms-client-request-id: true
      - name: return-client-request-id
        default: false
        in: header
        required: false
        type: boolean
        description: Whether the server should return the client-request-id in the response.
        x-ms-parameter-grouping:
          postfix: Options
      - name: ocp-date
        in: header
        required: false
        type: string
        format: date-time-rfc1123
        description: The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.
        x-ms-parameter-grouping:
          postfix: Options
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '200':
          headers:
            client-request-id:
              description: The client-request-id provided by the client during the request. This will be returned only if the return-client-request-id parameter was set to true.
              type: string
              format: uuid
            request-id:
              description: A unique identifier for the request that was made to the Batch service. If a request is consistently failing and you have verified that the request is properly formulated, you may use this value to report the error to Microso

# --- truncated at 32 KB (120 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/microsoft-azure-computenodes-api-openapi.yml