Guía del usuario de recursos en cola

Los recursos en cola te permiten solicitar recursos de Cloud TPU en cola. Cuando solicitas recursos en cola, la solicitud se agrega a una cola que mantiene el servicio de Cloud TPU. Cuando el recurso solicitado está disponible, a tu proyecto de Google Cloud para uso exclusivo de inmediato. Permanecerá a tu proyecto, a menos que lo borres o se interrumpa. Solo Las VMs Spot de TPU y las TPU interrumpibles son aptas para la interrupción.

Puedes especificar un estado hora de inicio y finalización en una fila solicitud de recursos. La hora de inicio especifica la hora más temprana en la que se completará el la solicitud. Si una solicitud no se completa hasta la hora de finalización especificada, el que venza la solicitud. La solicitud permanece en la cola después de que vence.

Las solicitudes de recursos en cola pueden tener uno de los siguientes estados:

WAITING_FOR_RESOURCES
La solicitud pasó la validación inicial y se agregó a la cola. Permanece en este estado hasta que haya suficientes recursos libres para comenzar. aprovisionar tu solicitud o el intervalo de asignación el tiempo transcurrido. Cuando la demanda es alta, no todas las solicitudes pueden ser inmediatamente o con el que se aprovisionen. Si necesitas una capacidad de obtener TPU más confiable, considera compra una reserva.
PROVISIONING
Se seleccionó la solicitud de la cola y se están asignando sus recursos.
ACTIVE
Se asignó la solicitud. Cuando las solicitudes de recursos en cola están en ACTIVE, puedes administrar las VMs de TPU como se describe en Administra las TPU.
FAILED
No se pudo completar la solicitud, ya sea porque ocurrió un problema con el o los recursos solicitados no estaban disponibles dentro del intervalo de asignación. La solicitud permanece en la cola hasta que se borra explícitamente.
SUSPENDING
Se están borrando los recursos asociados con la solicitud.
SUSPENDED
Se borraron los recursos especificados en la solicitud. Cuando se envía una solicitud está en el estado SUSPENDED, ya no es apto para de asignación.

Requisitos previos

Antes de ejecutar los comandos de esta guía, asegúrate de hacer lo siguiente:

Cómo solicitar un recurso en cola a pedido

Puedes solicitar un recurso en cola a pedido con el comando gcloud compute tpus queued-resources create. Para obtener más información según demanda, consulta Tipos de cuotas.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project \
  --zone us-central2-b \
  --accelerator-type v4-8 \
  --runtime-version tpu-vm-tf-2.17.0-pjrt

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
'tpu': {
  'node_spec': {
    'parent': 'projects/your-project-number/locations/us-central2-b',
    'node_id': 'your-node-id',
    'node': {
      'accelerator_type': 'v4-8',
      'runtime_version': 'tpu-vm-tf-2.17.0-pjrt',
    }
  }
}
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de parámetros de comando

queued-resource-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
El ID de la TPU asignado por el usuario que se crea cuando se pone en cola se asigna la solicitud del recurso.
project
Tu proyecto de Google Cloud.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.

Tamaños predeterminados de porciones para recursos en cola a pedido

Cuando utilizas la cuota según demanda, debes solicitar un tamaño de porción menor que el límite predeterminado para el tipo de acelerador que usas. Las solicitudes que superen el los límites predeterminados son rechazados por el sistema.

En la siguiente tabla, se muestran los tipos de TPU y sus respectivos con límites predeterminados.

Tipo de acelerador Límite predeterminado (en cantidad de tensores)
v2 128
v3 128
v4 384
v5 32

Si necesitas porciones de mayor tamaño, comunícate con Cloud TPU. asistencia para obtener información adicional.

Solicita un recurso en cola mediante una reserva

Puedes solicitar un recurso en cola mediante una reserva especificando La marca --reserved en el comando gcloud o guaranteed.reserved=true en el archivo curl. Para comprar una reserva, comunícate con el equipo de cuentas de Google Cloud.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project \
  --zone us-central2-b \
  --accelerator-type v4-8 \
  --runtime-version tpu-vm-tf-2.17.0-pjrt \
  --reserved

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
'tpu': {
  'node_spec': {
    'parent': 'projects/your-project-number/locations/us-central2-b',
    'node_id': 'your-node-id',
    'node': {
      'accelerator_type': 'v4-8',
      'runtime_version': 'tpu-vm-tf-2.17.0-pjrt',
    }
  }
},
'guaranteed': {
  'reserved': true,
}
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de parámetros de comando

queued-resource-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
El ID de la TPU asignado por el usuario que se crea cuando se pone en cola se asigna la solicitud del recurso.
project
Tu proyecto de Google Cloud.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.
reserved
Usa esta marca cuando solicites recursos en cola como parte de una Cloud TPU reserva.

Solicita un recurso en cola de VM Spot de TPU

Una VM Spot es un recurso que se puede interrumpir y asignar a otra carga de trabajo en cualquier momento. Recursos de VM Spot cuesta menos y es posible que obtengas acceso a los recursos más rápido, en comparación con un una solicitud de VM no Spot. Para obtener más información sobre TPU Para VMs Spot, consulta Administra VMs Spot de TPU.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project-id \
  --zone us-central2-b \
  --accelerator-type v4-8 \
  --runtime-version tpu-vm-tf-2.17.0-pjrt \
  --spot

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
'tpu': {
  'node_spec': {
    'parent': 'projects/your-project-number/locations/us-central2-b',
    'node_id': 'your-node-id',
    'node': {
      'accelerator_type': 'v4-8',
      'runtime_version': 'tpu-vm-tf-2.17.0-pjrt'
    }
  }
},
'spot': {}
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de parámetros de comando

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
Es el ID definido por el usuario de la TPU que se creó en respuesta a la solicitud.
project
Es el ID del proyecto en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.
spot
Es una marca booleana que especifica que el recurso en cola es una VM Spot.

Solicita que se asigne un recurso en cola antes o después de un tiempo especificado

Puedes especificar una hora de inicio opcional, finalización. hora, inicio duración o finalización de duración en una solicitud de recurso en cola. El la hora de inicio o la duración de inicio especifica el horario más antiguo en el que se completará el para cada solicitud. Si una solicitud no se completa antes de la hora de finalización especificada o dentro del la duración especificada, se vence la solicitud. Una vez que la solicitud expiró, permanece en la cola, pero ya no es apto para la asignación.

También puedes especificar un intervalo de asignación que especifica una hora de inicio o duración, y una hora de finalización o duración.

Consulta Datetime para un una lista de los formatos de marca de tiempo y duración admitidos.

Solicita un recurso en cola después de una duración especificada

Puedes especificar la duración después de la cual se debe asignar un recurso mediante la marca --valid-after-duration. En el siguiente ejemplo, se solicita que una v4-32 una asignación después de seis horas.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project-id \
  --zone us-central2-b \
  --accelerator-type v4-32 \
  --runtime-version tpu-vm-tf-2.17.0-pod-pjrt \
  --valid-after-duration 6h

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
'tpu': {
  'node_spec': {
    'parent': 'projects/your-project-number/locations/us-central2-b',
    'node_id': 'your-node-id',
    'node': {
      'accelerator_type': 'v4-32',
      'runtime_version': 'tpu-vm-tf-2.17.0-pod-pjrt',
    }
  }
},
'queueing_policy': {
  'valid_after_duration': {
    'seconds': 21600
  }
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de parámetros de comando

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
Es el ID definido por el usuario de la TPU que se creó en respuesta a la solicitud.
project
El proyecto de Google Cloud en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.
valid-after-duration
Es la duración antes de la cual no se debe aprovisionar la TPU. Para obtener más información sobre los formatos de duración, consulta Fecha y hora del tema de Google Cloud CLI

Solicita un recurso en cola que venza después de una duración especificada

Puedes especificar durante cuánto tiempo es válida una solicitud de recurso en cola con la marca --valid-until-duration. El siguiente ejemplo solicita una v4-32 que vence si no se completan en seis horas.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project-id \
  --zone us-central2-b \
  --accelerator-type v4-32 \
  --runtime-version tpu-vm-tf-2.17.0-pod-pjrt \
  --valid-until-duration 6h

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
'tpu': {
  'node_spec': {
    'parent': 'projects/your-project-number/locations/us-central2-b',
    'node_id': 'your-node-id',
    'node': {
      'accelerator_type': 'v4-32',
      'runtime_version': 'tpu-vm-tf-2.17.0-pod-pjrt',
    }
  }
},
'queueing_policy': {
  'valid_until_duration': {
    'seconds': 21600
  }
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de parámetros de comando

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
Es el ID definido por el usuario de la TPU que se creó en respuesta a la solicitud.
project
El proyecto de Google Cloud en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.
valid-until-duration
Es la duración de la validez de la solicitud. Para obtener más información sobre los formatos de duración, consulta Fecha y hora del tema de Google Cloud CLI

Cómo solicitar un recurso en cola después de un tiempo especificado

Puedes especificar el momento en el que se debe asignar un recurso con el método --valid-after-time.

El siguiente comando solicita una TPU v4-4096 con la versión del entorno de ejecución tpu-vm-tf-2.17.0-pjrt se asignará después de las 9 a.m. del 14 de diciembre de 2022.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project-id \
  --zone us-central2-b \
  --accelerator-type v4-4096 \
  --runtime-version tpu-vm-tf-2.17.0-pod-pjrt \
  --valid-after-time 2022-12-14T09:00:00Z

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
'tpu': {
  'node_spec': {
    'parent': 'projects/your-project-number/locations/us-central2-b',
    'node_id': 'your-node-id',
    'node': {
      'accelerator_type': 'v4-4096',
      'runtime_version': 'tpu-vm-tf-2.17.0-pod-pjrt',
    }
  }
},
'queueing_policy': {
  'valid_after_time': {
    'seconds': 2022-12-14T09:00:00Z
  }
}
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de parámetros de comando

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
Es el ID definido por el usuario de la TPU que se creó en respuesta a la solicitud.
project
El proyecto de Google Cloud en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.
valid-after-time
La hora, después de la cual se debe asignar el recurso. Para obtener más información sobre los formatos de duración, consulta Fecha y hora del tema de Google Cloud CLI.

Cómo solicitar un recurso en cola antes del tiempo especificado

Puedes especificar la hora en la que se debe asignar el recurso con el método --valid-until-time.

El siguiente comando solicita una TPU v4-4096 con la versión del entorno de ejecución tpu-vm-tf-2.10.0-pod se creará, a más tardar, el 14 de diciembre de 2022 a las 9:00 a.m.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project-id \
  --zone us-central2-b \
  --accelerator-type v4-4096 \
  --runtime-version tpu-vm-tf-2.17.0-pod-pjrt \
  --valid-until-time 2022-12-14T09:00:00Z

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
'tpu': {
  'node_spec': {
    'parent': 'projects/your-project-number/locations/us-central2-b',
    'node_id': 'your-node-id',
    'node': {
      'accelerator_type': 'v4-4096',
      'runtime_version': 'tpu-vm-tf-2.17.0-pod-pjrt',
    }
  }
},
'queueing_policy': {
  'valid_until_time': {
    'seconds': 1655197200
  }
}
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de parámetros de comando

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
Es el ID definido por el usuario de la TPU que se creó en respuesta a la solicitud.
project
Es el ID del proyecto en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.
valid-until-time
Es el momento en el que se cancela la solicitud. Para obtener más información sobre los formatos de duración, consulta Fecha y hora del tema de Google Cloud CLI.

Solicita que se asigne un recurso en cola dentro de un intervalo especificado

Puedes especificar un intervalo de asignación con cualquier par de --valid-after-time. las marcas --valid-after-duration, --valid-until-duration y --valid-until-time, proporcionado one especifica el inicio del intervalo de asignación y el Otro especifica el final del intervalo de asignación.

El siguiente comando solicita una v4-32 en 5 horas y 30 minutos al hora actual, a más tardar el 14 de diciembre de 2022 a las 9:00 a.m.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project-id \
  --zone us-central2-b \
  --accelerator-type v4-32 \
  --runtime-version tpu-vm-tf-2.17.0-pod-pjrt \
  --valid-after-duration 5h30m \
  --valid-until-time 2022-12-14T09:00:00Z

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
'tpu': {
  'node_spec': {
    'parent': 'projects/your-project-number/locations/us-central2-b',
    'node_id': 'your-node-id',
    'node': {
      'accelerator_type': 'v4-32',
      'runtime_version': 'tpu-vm-tf-2.17.0-pod-pjrt',
    }
  }
},
'queueing_policy': {
  'validInterval': {
    'startTime': '2022-12-10T14:30:00Z',
    'endTime': '2022-12-14T09:00:00Z'
  }
},
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de las marcas de comandos

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
Es el ID definido por el usuario de la TPU que se creó en respuesta a la solicitud.
project
Es el ID del proyecto en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.
valid-until-timw
Es el momento en el que se cancela la solicitud. Para obtener más información sobre los formatos de duración, consulta Fecha y hora del tema de Google Cloud CLI.
valid-until-duration
Es la duración de la validez de la solicitud. Para obtener más información sobre los formatos de duración, consulta Fecha y hora del tema de Google Cloud CLI.

Solicita un recurso en cola con una secuencia de comandos de inicio

Puedes especificar una secuencia de comandos para que se ejecute en un recurso en cola o con aprovisionamiento. Cuando usas el comando gcloud, puedes usar --metadata o --metadata-from-file para especificar un comando de secuencia de comandos o un archivo que contiene el código de la secuencia de comandos, respectivamente. Cuando uses curl, debes incluir la secuencia de comandos. en el contenido JSON. En el siguiente ejemplo, se crea un recurso en cola solicitud que ejecutará la secuencia de comandos que se encuentra en startup-script.sh. El curl ejemplo muestra una secuencia de comandos intercalada en el cuerpo JSON.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project \
  --zone us-central2-b \
  --accelerator-type v4-8 \
  --runtime-version tpu-vm-tf-2.12.0 \
  --metadata-from-file='startup-script=startup-script.sh'

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
tpu: {
    node_spec: {
      parent: 'projects/your-project-number/locations/us-central2-b',
      node_id: 'your-node-id',
      node: {
          accelerator_type: 'v2-8',
          runtime_version: 'tpu-vm-tf-2.17.0-pjrt',
          metadata: {
              "startup-script": "#! /bin/bash\npwd > /tmp/out.txt\nwhoami >> /tmp/out.txt"
          }
      }
    }
},
'queueing_policy': {
  'validInterval': {
    'startTime': '2022-12-10T14:30:00Z',
    'endTime': '2022-12-14T09:00:00Z'
  }
},
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de las marcas de comandos

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
Es el ID definido por el usuario de la TPU que se creó en respuesta a la solicitud.
project
Es el ID del proyecto en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.
validInterval
El tiempo durante el cual la solicitud es válida tras el cual se cumple cancelado. Para obtener más información sobre los formatos de duración, consulta Fecha y hora del tema de Google Cloud CLI.
metadata-from-file
Especifica un archivo que contiene metadatos. Si no especificas un valor calificada al archivo de metadatos, el comando supone que se encuentra en directorio actual. En este ejemplo, el archivo contiene una secuencia de comandos de inicio que se ejecuta cuando se aprovisiona el recurso en cola.
metadata
Especifica los metadatos para la solicitud. En este ejemplo, los metadatos son se ejecuta un comando de secuencia de comandos de inicio cuando se aprovisiona el recurso en cola.

Solicitar recursos en cola con una red y subred especificadas

Puedes solicitar un recurso en cola especificando la red y la subred a las que a la que quieres conectar tu TPU.

gcloud

gcloud compute tpus queued-resources create your-queued-resource-id \
  --node-id your-node-id \
  --project your-project \
  --zone us-central2-b \
  --accelerator-type v4-8 \
  --runtime-version tpu-vm-tf-2.17.0-pjrt \
  --network network-name \
  --subnetwork subnetwork-name

curl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d "{
'tpu': {
  'node_spec': {
    'parent': 'projects/your-project-number/locations/us-central2-b',
    'node_id': 'your-node-id',
    'node': {
      'accelerator_type': 'v4-8',
      'runtime_version': 'tpu-vm-tf-2.17.0-pjrt',
       'network_config': {
        'network': 'network-name',
        'subnetwork': 'subnetwork-name',
        'enable_external_ips': true
    }
  }
},
'guaranteed': {
  'reserved': true,
}
}" \
https://tpu.googleapis.com/v2alpha1/projects/your-project-id/locations/us-central2-b/queuedResources?queued_resource_id=your-queued-resource-id

Descripciones de parámetros de comando

queued-resource-id
El ID asignado por el usuario de la solicitud de recurso en cola.
node-id
El ID de la TPU asignado por el usuario que se crea cuando se pone en cola se asigna la solicitud del recurso.
project
Tu proyecto de Google Cloud.
zone
Es la zona en la que deseas crear la Cloud TPU.
accelerator-type
El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que deseas crear. Para obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.
runtime-version
La versión del software de Cloud TPU.
reserved
Usa esta marca cuando solicites recursos en cola como parte de una Cloud TPU reserva.
network
Una red de la que formará parte el recurso en cola.
subnetwork
Es una subred de la que formará parte el recurso en cola.

Borrar una solicitud de recurso en cola

Puedes borrar una solicitud de recurso en cola y la VM de TPU creada por la solicitud Pasa la marca --force al comando queued-resource delete. De lo contrario, debes borrar la VM de TPU antes de borrar la solicitud de recurso en cola. Cuando borrar la VM de TPU, la solicitud de recurso en cola pasa a la SUSPENDED, después de lo cual la solicitud de recurso en cola podría borrar.

Los siguientes comandos borran la solicitud de recurso en cola llamada “mi recurso-en-cola” en la sección “mi-proyecto” en la zona “us-central2-b”. Integra Usa la marca --force para borrar la VM de TPU y el recurso en cola para cada solicitud.

gcloud

gcloud compute tpus queued-resources delete my-queued-resource \
  --project my-project \
  --zone us-central2-b \
  --force \
  --async

curl

curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://tpu.googleapis.com/v2/projects/my-project/locations/us-central2-b/queuedResources/my-queued-resource?force=true

Descripciones de las marcas de comandos

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
project
El proyecto de Google Cloud en el que se asigna el recurso en cola.
zone
La zona de la Cloud TPU que se borrará.
force
Borra la VM de TPU y la solicitud de recurso en cola.

Los siguientes comandos borran la solicitud de recurso en cola llamada “my-queued-resource”. en la sección “mi-proyecto” en la zona “us-central2-b”.

gcloud

gcloud compute tpus queued-resources delete your-queued-resource-id \
  --project your-project-id \
  --zone us-central2-b

curl

curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://tpu.googleapis.com/v2/projects/your-project-id/locations/us-central2-b/queuedResources/your-queued-resource-id

Descripciones de las marcas de comandos

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
project
El proyecto de Google Cloud en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.

Recuperar información de estado y diagnóstico sobre una solicitud de recurso en cola

Recupera la información de estado y diagnóstico sobre una solicitud de recurso en cola:

gcloud

gcloud compute tpus queued-resources describe queued-resource-request-id \
  --project your-project-id \
  --zone us-central2-b

curl

curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://tpu.googleapis.com/v2/projects/your-project-id/locations/us-central2-b/queuedResources/your-queued-resource-id

Descripciones de las marcas de comandos

queued-resource-request-id
El ID asignado por el usuario de la solicitud de recurso en cola.
project
Es el ID del proyecto en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.

Si la solicitud falla, la respuesta contendrá información del error. Para una solicitud que está esperando recursos, el resultado será similar al siguiente:

name: projects/your-project-id/locations/us-central2-b/queuedResources/your-queued-resource-id
state:
  state: WAITING_FOR_RESOURCES
tpu:
  nodeSpec:
  - node:
      acceleratorType: v4-8
      bootDisk: {}
      networkConfig:
        enableExternalIps: true
      queuedResource: projects/your-project-number/locations/us-central2-b/queuedResources/your-queued-resource-id
      runtimeVersion: tpu-vm-tf-2.10.0
      schedulingConfig: {}
      serviceAccount: {}
      shieldedInstanceConfig: {}
      useTpuVm: true
    nodeId: your-node-id
    parent: projects/your-project-number/locations/us-central2-b

Enumera las solicitudes de recursos en cola de tu proyecto

Con el siguiente comando, se enumeran las solicitudes de recursos en cola del proyecto “your-project-id”:

gcloud

gcloud compute tpus queued-resources list --project your-project-id \
  --zone us-central2-b

curl

curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://tpu.googleapis.com/v2/projects/your-project-id/locations/us-central2-b/queuedResources

Descripciones de las marcas de comandos

project
El proyecto de Google Cloud en el que se asigna el recurso en cola.
zone
Es la zona en la que deseas crear la Cloud TPU.