Package google.cloud.gdchardwaremanagement.v1alpha

Índice

GDCHardwareManagement

Es el servicio de gestión de hardware de GDC.

CancelOrder

rpc CancelOrder(CancelOrderRequest) returns (Operation)

Cancela un pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.orders.submit

Para obtener más información, consulta la documentación de IAM.

CreateComment

rpc CreateComment(CreateCommentRequest) returns (Operation)

Crea un comentario nuevo en un pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.comments.create

Para obtener más información, consulta la documentación de IAM.

CreateHardware

rpc CreateHardware(CreateHardwareRequest) returns (Operation)

Crea hardware nuevo en un proyecto y una ubicación determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.hardware.create

Para obtener más información, consulta la documentación de IAM.

CreateHardwareGroup

rpc CreateHardwareGroup(CreateHardwareGroupRequest) returns (Operation)

Crea un grupo de hardware nuevo en un pedido determinado.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.hardwareGroups.create

Para obtener más información, consulta la documentación de IAM.

CreateOrder

rpc CreateOrder(CreateOrderRequest) returns (Operation)

Crea un pedido nuevo en un proyecto y una ubicación determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.orders.create

Para obtener más información, consulta la documentación de IAM.

CreateSite

rpc CreateSite(CreateSiteRequest) returns (Operation)

Crea un sitio nuevo en un proyecto y una ubicación determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.sites.create

Para obtener más información, consulta la documentación de IAM.

CreateZone

rpc CreateZone(CreateZoneRequest) returns (Operation)

Crea una zona nueva en un proyecto y una ubicación determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.zones.create

Para obtener más información, consulta la documentación de IAM.

DeleteHardware

rpc DeleteHardware(DeleteHardwareRequest) returns (Operation)

Borra el hardware.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.hardware.delete

Para obtener más información, consulta la documentación de IAM.

DeleteHardwareGroup

rpc DeleteHardwareGroup(DeleteHardwareGroupRequest) returns (Operation)

Borra un grupo de hardware.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.hardwareGroups.delete

Para obtener más información, consulta la documentación de IAM.

DeleteOrder

rpc DeleteOrder(DeleteOrderRequest) returns (Operation)

Borra un pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.orders.delete

Para obtener más información, consulta la documentación de IAM.

DeleteSite

rpc DeleteSite(DeleteSiteRequest) returns (Operation)

Borra un sitio.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.sites.delete

Para obtener más información, consulta la documentación de IAM.

DeleteZone

rpc DeleteZone(DeleteZoneRequest) returns (Operation)

Borra una zona.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.zones.delete

Para obtener más información, consulta la documentación de IAM.

GetChangeLogEntry

rpc GetChangeLogEntry(GetChangeLogEntryRequest) returns (ChangeLogEntry)

Obtiene detalles de un cambio en un pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.changeLogEntries.get

Para obtener más información, consulta la documentación de IAM.

GetComment

rpc GetComment(GetCommentRequest) returns (Comment)

Obtiene el contenido de un comentario.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.comments.get

Para obtener más información, consulta la documentación de IAM.

GetHardware

rpc GetHardware(GetHardwareRequest) returns (Hardware)

Obtiene detalles del hardware.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.hardware.get

Para obtener más información, consulta la documentación de IAM.

GetHardwareGroup

rpc GetHardwareGroup(GetHardwareGroupRequest) returns (HardwareGroup)

Obtiene detalles de un grupo de hardware.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.hardwareGroups.get

Para obtener más información, consulta la documentación de IAM.

GetOrder

rpc GetOrder(GetOrderRequest) returns (Order)

Obtiene detalles de un pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.orders.get

Para obtener más información, consulta la documentación de IAM.

GetSite

rpc GetSite(GetSiteRequest) returns (Site)

Obtiene detalles de un sitio.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.sites.get

Para obtener más información, consulta la documentación de IAM.

GetSku

rpc GetSku(GetSkuRequest) returns (Sku)

Obtiene detalles de un SKU.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.skus.get

Para obtener más información, consulta la documentación de IAM.

GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

Obtiene detalles de una zona.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.zones.get

Para obtener más información, consulta la documentación de IAM.

ListChangeLogEntries

rpc ListChangeLogEntries(ListChangeLogEntriesRequest) returns (ListChangeLogEntriesResponse)

Enumera los cambios realizados en un pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.changeLogEntries.list

Para obtener más información, consulta la documentación de IAM.

ListComments

rpc ListComments(ListCommentsRequest) returns (ListCommentsResponse)

Enumera los comentarios de un pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.comments.list

Para obtener más información, consulta la documentación de IAM.

ListHardware

rpc ListHardware(ListHardwareRequest) returns (ListHardwareResponse)

Enumera el hardware en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.hardware.list

Para obtener más información, consulta la documentación de IAM.

ListHardwareGroups

rpc ListHardwareGroups(ListHardwareGroupsRequest) returns (ListHardwareGroupsResponse)

Enumera los grupos de hardware en un orden determinado.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.hardwareGroups.list

Para obtener más información, consulta la documentación de IAM.

ListOrders

rpc ListOrders(ListOrdersRequest) returns (ListOrdersResponse)

Enumera los pedidos en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.orders.list

Para obtener más información, consulta la documentación de IAM.

ListSites

rpc ListSites(ListSitesRequest) returns (ListSitesResponse)

Enumera los sitios en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.sites.list

Para obtener más información, consulta la documentación de IAM.

ListSkus

rpc ListSkus(ListSkusRequest) returns (ListSkusResponse)

Enumera los SKU de un proyecto y una ubicación determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.skus.list

Para obtener más información, consulta la documentación de IAM.

ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

Enumera las zonas en una ubicación y un proyecto determinados.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.zones.list

Para obtener más información, consulta la documentación de IAM.

RecordActionOnComment

rpc RecordActionOnComment(RecordActionOnCommentRequest) returns (Comment)

Registra la acción en un comentario. Si la acción especificada en la solicitud es READ, la hora de visualización del comentario se establece en la hora en que se recibió la solicitud. Si el comentario ya está marcado como leído, se ignorarán las llamadas posteriores. Si la acción es UNREAD, se borra la hora de visualización del comentario.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

RequestOrderDateChange

rpc RequestOrderDateChange(RequestOrderDateChangeRequest) returns (Operation)

Actualiza el cambio de fecha solicitado de un solo pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.orders.update

Para obtener más información, consulta la documentación de IAM.

SignalZoneState

rpc SignalZoneState(SignalZoneStateRequest) returns (Operation)

Indica el estado de una zona.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.zones.update

Para obtener más información, consulta la documentación de IAM.

SubmitOrder

rpc SubmitOrder(SubmitOrderRequest) returns (Operation)

Envía un pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.orders.submit

Para obtener más información, consulta la documentación de IAM.

UpdateHardware

rpc UpdateHardware(UpdateHardwareRequest) returns (Operation)

Actualiza los parámetros de hardware.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.hardware.update

Para obtener más información, consulta la documentación de IAM.

UpdateHardwareGroup

rpc UpdateHardwareGroup(UpdateHardwareGroupRequest) returns (Operation)

Actualiza los parámetros de un grupo de hardware.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.hardwareGroups.update

Para obtener más información, consulta la documentación de IAM.

UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Operation)

Actualiza los parámetros de un pedido.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.orders.update

Para obtener más información, consulta la documentación de IAM.

UpdateSite

rpc UpdateSite(UpdateSiteRequest) returns (Operation)

Actualiza los parámetros de un sitio.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.sites.update

Para obtener más información, consulta la documentación de IAM.

UpdateZone

rpc UpdateZone(UpdateZoneRequest) returns (Operation)

Actualiza los parámetros de una zona.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gdchardwaremanagement.zones.update

Para obtener más información, consulta la documentación de IAM.

CancelOrderRequest

Es una solicitud para cancelar un pedido.

Campos
name

string

Obligatorio. Es el nombre del pedido. Formato: projects/{project}/locations/{location}/orders/{order}

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

ChangeLogEntry

Es una entrada de registro de un cambio realizado en un pedido.

Campos
name

string

Es el identificador. Es el nombre de esta entrada de registro de cambios. Formato: projects/{project}/locations/{location}/orders/{order}/changeLogEntries/{change_log_entry}

create_time

Timestamp

Solo salida. Fecha y hora en que se creó esta entrada de registro de cambios.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a esta entrada de registro de cambios como pares clave-valor. Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

log

string

Solo salida. Es el contenido de esta entrada de registro.

Comentario

Es un comentario sobre un pedido.

Campos
name

string

Es el identificador. Nombre de este comentario. Formato: projects/{project}/locations/{location}/orders/{order}/comments/{comment}

create_time

Timestamp

Solo salida. Fecha y hora en que se creó este comentario.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este comentario como pares clave-valor. Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

author

string

Solo salida. Nombre de usuario del autor de este comentario. Este campo se completa automáticamente con las credenciales que se usaron durante la creación del comentario.

text

string

Obligatorio. Texto de este comentario. La longitud del texto debe ser menor o igual a 1,000 caracteres.

customer_viewed_time

Timestamp

Solo salida. Es la marca de tiempo de la primera vez que el cliente vio este comentario. Si no se vio el comentario, no se establecerá esta marca de tiempo.

author_entity

Entity

Solo salida. Es la entidad a la que pertenece el autor.

Contacto

Son los detalles de contacto de un punto de contacto.

Campos
given_name

string

Obligatorio. Nombre de pila del contacto.

family_name

string

Es opcional. Apellido del contacto.

email

string

Obligatorio. Es el correo electrónico principal del contacto.

secondary_emails[]

string

Es opcional. Es la lista completa de los correos electrónicos secundarios del contacto.

phone

string

Obligatorio. Número de teléfono del contacto.

time_zone

TimeZone

Es opcional. Zona horaria del contacto.

reachable_times[]

TimePeriod

Es opcional. Son los períodos en los que se puede comunicar con el contacto. Si este campo está vacío, se puede comunicar con el contacto en cualquier momento.

notes

string

Es opcional. Notas de formato libre que detallan cómo desea el contacto recibir notificaciones. Por ejemplo, es posible que tengan un método de contacto preferido o que deseen recibir una copia de cualquier derivación posterior.

CreateCommentRequest

Es una solicitud para crear un comentario.

Campos
parent

string

Obligatorio. Es el pedido en el que se creará el comentario. Formato: projects/{project}/locations/{location}/orders/{order}

comment_id

string

Es opcional. Es el ID que se usa para identificar de forma única el comentario dentro de su alcance principal. Este campo debe contener un máximo de 63 caracteres y debe comenzar con caracteres en minúscula. Solo se aceptan caracteres en minúscula, números y -. El carácter - no puede ser el primero ni el último. Si no se configura el campo, se usará un ID generado por el sistema.

Se ignorará el campo comment.name en la solicitud.

comment

Comment

Obligatorio. Es el comentario que se creará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

CreateHardwareGroupRequest

Es una solicitud para crear un grupo de hardware.

Campos
parent

string

Obligatorio. Es el orden en el que se creará el grupo de hardware. Formato: projects/{project}/locations/{location}/orders/{order}

hardware_group_id

string

Es opcional. Es el ID que se usa para identificar de forma única el HardwareGroup dentro de su alcance principal. Este campo debe contener un máximo de 63 caracteres y debe comenzar con caracteres en minúscula. Solo se aceptan caracteres en minúscula, números y -. El carácter - no puede ser el primero ni el último. Si no se configura el campo, se usará un ID generado por el sistema.

Se ignorará el campo hardware_group.name en la solicitud.

hardware_group

HardwareGroup

Obligatorio. Es el grupo de hardware que se creará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

CreateHardwareRequest

Es una solicitud para crear hardware.

Campos
parent

string

Obligatorio. Es el proyecto y la ubicación en los que se creará el hardware. Formato: projects/{project}/locations/{location}

hardware_id

string

Es opcional. Es el ID que se usa para identificar de forma única el hardware dentro de su alcance principal. Este campo debe contener un máximo de 63 caracteres y debe comenzar con caracteres en minúscula. Solo se aceptan caracteres en minúscula, números y -. El carácter - no puede ser el primero ni el último. Si no se configura el campo, se usará un ID generado por el sistema.

Se ignorará el campo hardware.name en la solicitud.

hardware

Hardware

Obligatorio. Es el recurso que se creará.

CreateOrderRequest

Es una solicitud para crear un pedido.

Campos
parent

string

Obligatorio. Es el proyecto y la ubicación en los que se creará el pedido. Formato: projects/{project}/locations/{location}

order_id

string

Es opcional. Es el ID que se usa para identificar de forma única el pedido dentro de su alcance principal. Este campo debe contener un máximo de 63 caracteres y debe comenzar con caracteres en minúscula. Solo se aceptan caracteres en minúscula, números y -. El carácter - no puede ser el primero ni el último. Si no se configura el campo, se usará un ID generado por el sistema.

Se ignorará el campo order.name en la solicitud.

order

Order

Obligatorio. Es el pedido que se creará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

CreateSiteRequest

Es una solicitud para crear un sitio.

Campos
parent

string

Obligatorio. Proyecto y ubicación en los que se creará el sitio. Formato: projects/{project}/locations/{location}

site_id

string

Es opcional. Es el ID que se usa para identificar de forma única el sitio dentro de su alcance principal. Este campo debe contener un máximo de 63 caracteres y debe comenzar con caracteres en minúscula. Solo se aceptan caracteres en minúscula, números y -. El carácter - no puede ser el primero ni el último. Si no se configura el campo, se usará un ID generado por el sistema.

Se ignorará el campo site.name en la solicitud.

site

Site

Obligatorio. Es el sitio que se creará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

CreateZoneRequest

Es una solicitud para crear una zona.

Campos
parent

string

Obligatorio. Es el proyecto y la ubicación en los que se creará la zona. Formato: projects/{project}/locations/{location}

zone_id

string

Es opcional. Es el ID que se usa para identificar de forma única la zona dentro de su alcance principal. Este campo debe contener un máximo de 63 caracteres y debe comenzar con caracteres en minúscula. Solo se aceptan caracteres en minúscula, números y -. El carácter - no puede ser el primero ni el último. Si no se configura el campo, se usará un ID generado por el sistema.

Se ignorará el campo zone.name en la solicitud.

zone

Zone

Obligatorio. Es la zona que se creará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

DeleteHardwareGroupRequest

Es una solicitud para borrar un grupo de hardware.

Campos
name

string

Obligatorio. Es el nombre del grupo de hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

DeleteHardwareRequest

Es una solicitud para borrar hardware.

Campos
name

string

Obligatorio. Es el nombre del hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

DeleteOrderRequest

Es una solicitud para borrar un pedido.

Campos
name

string

Obligatorio. Es el nombre del pedido. Formato: projects/{project}/locations/{location}/orders/{order}

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

force

bool

Es opcional. Opción para borrar cualquier recurso anidado en el pedido, como un HardwareGroup. Si es verdadero, también se borrarán los recursos anidados de este pedido. De lo contrario, la solicitud solo tendrá éxito si el pedido no tiene recursos anidados.

DeleteSiteRequest

Es una solicitud para borrar un sitio.

Campos
name

string

Obligatorio. Es el nombre del sitio. Formato: projects/{project}/locations/{location}/sites/{site}

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

DeleteZoneRequest

Es una solicitud para borrar una zona.

Campos
name

string

Obligatorio. Es el nombre de la zona. Formato: projects/{project}/locations/{location}/zones/{zone}

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

Dimensiones

Representa las dimensiones de un objeto.

Campos
width_inches

float

Obligatorio. Ancho en pulgadas.

height_inches

float

Obligatorio. Altura en pulgadas.

depth_inches

float

Obligatorio. Profundidad en pulgadas.

Entidad

La entidad se usa para denotar una organización o un partido.

Enums
ENTITY_UNSPECIFIED La entidad no se especifica.
GOOGLE Google.
CUSTOMER Cliente.
VENDOR Proveedor.

GetChangeLogEntryRequest

Es una solicitud para obtener una entrada de registro de cambios.

Campos
name

string

Obligatorio. Es el nombre de la entrada de registro de cambios. Formato: projects/{project}/locations/{location}/orders/{order}/changeLogEntries/{change_log_entry}

GetCommentRequest

Es una solicitud para obtener un comentario.

Campos
name

string

Obligatorio. Es el nombre del comentario. Formato: projects/{project}/locations/{location}/orders/{order}/comments/{comment}

GetHardwareGroupRequest

Es una solicitud para obtener un grupo de hardware.

Campos
name

string

Obligatorio. Es el nombre del grupo de hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

GetHardwareRequest

Es una solicitud para obtener hardware.

Campos
name

string

Obligatorio. Es el nombre del hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}

GetOrderRequest

Es una solicitud para obtener un pedido.

Campos
name

string

Obligatorio. Nombre del recurso

GetSiteRequest

Es una solicitud para obtener un sitio.

Campos
name

string

Obligatorio. Es el nombre del sitio. Formato: projects/{project}/locations/{location}/sites/{site}

GetSkuRequest

Es una solicitud para obtener un SKU.

Campos
name

string

Obligatorio. Es el nombre del SKU. Formato: projects/{project}/locations/{location}/skus/{sku}

GetZoneRequest

Es una solicitud para obtener una zona.

Campos
name

string

Obligatorio. Es el nombre de la zona. Formato: projects/{project}/locations/{location}/zones/{zone}

Hardware

Es una instancia de hardware instalada en un sitio.

Campos
name

string

Es el identificador. Nombre de este hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}

display_name

string

Es opcional. Nombre visible de este hardware.

create_time

Timestamp

Solo salida. Fecha y hora en que se creó este hardware.

update_time

Timestamp

Solo salida. Fecha y hora en que se actualizó este hardware por última vez.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas con este hardware como pares clave-valor. Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

order

string

Obligatorio. Es el nombre del pedido al que pertenece este hardware. Formato: projects/{project}/locations/{location}/orders/{order}

hardware_group

string

Solo salida. Nombre del grupo de hardware al que pertenece este hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

site

string

Obligatorio. Nombre del sitio al que pertenece este hardware. Formato: projects/{project}/locations/{location}/sites/{site}

state

State

Solo salida. Es el estado actual de este hardware.

ciq_uri

string

Solo salida. Vínculo a la hoja del Cuestionario de admisión del cliente (CIQ) para este hardware.

config

HardwareConfig

Obligatorio. Es la configuración de este hardware.

estimated_installation_date

Date

Solo salida. Es la fecha de instalación estimada de este hardware.

physical_info

HardwarePhysicalInfo

Es opcional. Son las propiedades físicas de este hardware.

installation_info

HardwareInstallationInfo

Es opcional. Es la información para la instalación de este hardware.

zone

string

Obligatorio. Nombre de la zona a la que pertenece este hardware. Formato: projects/{project}/locations/{location}/zones/{zone}

requested_installation_date
(deprecated)

Date

Es opcional. Obsoleto: La fecha de instalación solicitada se trasladó al recurso Order. En su lugar, usa customer_requested_installation_date en el recurso Order.

actual_installation_date

Date

Solo salida. Fecha de instalación real de este hardware. Google completa este campo.

machine_infos[]

MachineInfo

Solo salida. Es la información de los activos por máquina necesaria para la activación.

estimated_delivery_date

Date

Solo salida. Es la fecha de entrega estimada del hardware.

DiskInfo

Es información sobre los discos individuales de una máquina.

Campos
manufacturer

string

Solo salida. Fabricante del disco.

slot

int32

Solo salida. Número de ranura del disco.

serial_number

string

Solo salida. Número de serie del disco.

psid

string

Solo salida. Es el PSID del disco.

part_number

string

Solo salida. Es el número de pieza del disco.

model_number

string

Solo salida. Número de modelo del disco.

MacAddress

Es un mensaje para describir la dirección MAC de una máquina.

Campos
address

string

Solo salida. Es una cadena de dirección.

type

AddressType

Solo salida. Tipo de dirección para esta dirección MAC.

ipv4_address

string

Solo salida. Dirección IP estática (si se usa) asociada a la dirección MAC. Solo se aplica al tipo de dirección MAC VIRTUAL.

AddressType

Es una enumeración para los diferentes tipos de direcciones MAC.

Enums
ADDRESS_TYPE_UNSPECIFIED Es un tipo de dirección sin especificar.
NIC Es la dirección de una tarjeta de interfaz de red.
BMC Es la dirección de un controlador de administración de la placa base.
VIRTUAL Es la dirección de una interfaz virtual.

MachineInfo

Es la información sobre los proveedores de máquinas individuales que se proporcionará durante la puesta en marcha.

Campos
service_tag

string

Solo salida. Es la etiqueta de servicio de la máquina.

mac_addresses[]

MacAddress

Solo salida. Cada dirección MAC asociada.

name

string

Solo salida. Nombre de la máquina.

disk_infos[]

DiskInfo

Solo salida. Es la información de cada disco instalado.

Estado

Estados válidos para el hardware.

Enums
STATE_UNSPECIFIED El estado del hardware no está especificado.
ADDITIONAL_INFO_NEEDED Se requiere más información del cliente para avanzar.
BUILDING Google comenzó a fabricar el hardware para este dispositivo.
SHIPPING El hardware se fabricó y se está enviando.
INSTALLING Se está instalando el hardware.
INSTALLED Se instaló el hardware.
FAILED Se produjo un error y se requiere la intervención del cliente.

HardwareConfig

Es la configuración del hardware de GDC.

Campos
sku

string

Obligatorio. Es la referencia al SKU de este hardware. Puede apuntar a una revisión de SKU específica en el formato resource_name@revision_id, como se define en AIP-162. Si no se especifica ningún revision_id, se hace referencia a la revisión más reciente.

power_supply

PowerSupply

Obligatorio. Tipo de fuente de alimentación de este hardware.

subscription_duration_months

int32

Es opcional. Es la duración de la suscripción del hardware en meses.

HardwareGroup

Es un grupo de hardware que forma parte del mismo pedido, tiene el mismo SKU y se entrega en el mismo sitio.

Campos
name

string

Es el identificador. Es el nombre de este grupo de hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

create_time

Timestamp

Solo salida. Fecha y hora en que se creó este grupo de hardware.

update_time

Timestamp

Solo salida. Fecha y hora en que se actualizó este grupo de hardware por última vez.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este grupo de hardware como pares clave-valor. Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

hardware_count

int32

Obligatorio. Es la cantidad de hardware en este HardwareGroup.

config

HardwareConfig

Obligatorio. Es la configuración del hardware en este HardwareGroup.

site

string

Obligatorio. Es el nombre del sitio en el que se entregará el hardware de este HardwareGroup. Formato: projects/{project}/locations/{location}/sites/{site}

state

State

Solo salida. Es el estado actual de este HardwareGroup.

zone

string

Es opcional. Es el nombre de la zona a la que pertenece el hardware de este HardwareGroup. Formato: projects/{project}/locations/{location}/zones/{zone}

requested_installation_date
(deprecated)

Date

Es opcional. Obsoleto: Este valor no se usa. En su lugar, usa el campo requested_installation_date en el recurso Order.

Estado

Son los estados válidos de un HardwareGroup.

Enums
STATE_UNSPECIFIED El estado de HardwareGroup no está especificado.
ADDITIONAL_INFO_NEEDED Se requiere más información del cliente para avanzar.
BUILDING Google inició la compilación de hardware para este HardwareGroup.
SHIPPING El hardware se fabricó y se está enviando.
INSTALLING Se está instalando el hardware.
PARTIALLY_INSTALLED Se instaló parte del hardware del HardwareGroup.
INSTALLED Se instaló todo el hardware del HardwareGroup.
FAILED Se produjo un error y se requiere la intervención del cliente.

HardwareInstallationInfo

Es la información para la instalación de un hardware.

Campos
rack_location

string

Obligatorio. Ubicación del rack en el sitio, p.ej., piso 2, habitación 201, fila 7, rack 3.

power_distance_meters

int32

Obligatorio. Distancia desde el tomacorriente en metros

switch_distance_meters

int32

Obligatorio. Distancia desde el switch de red en metros

rack_unit_dimensions

Dimensions

Obligatorio. Son las dimensiones de la unidad de bastidores.

rack_space

RackSpace

Obligatorio. Es el espacio de bastidor asignado para el hardware.

rack_type

RackType

Obligatorio. Es el tipo de estructura.

RackType

Son los tipos de soporte válidos.

Enums
RACK_TYPE_UNSPECIFIED No se especificó el tipo de estructura.
TWO_POST Bastidor de dos postes
FOUR_POST Bastidor de cuatro postes.

HardwareLocation

Representa la ubicación de uno o varios equipos.

Campos
site

string

Obligatorio. Nombre del sitio en el que se encuentra el hardware. Formato: projects/{project}/locations/{location}/sites/{site}

rack_location

string

Obligatorio. Ubicación del rack en el sitio, p.ej., piso 2, habitación 201, fila 7, rack 3.

rack_space[]

RackSpace

Es opcional. Espacios que ocupa el hardware en el rack. Si no se configura, se supone que esta ubicación es todo el rack.

HardwarePhysicalInfo

Son las propiedades físicas de un hardware.

Campos
power_receptacle

PowerReceptacleType

Obligatorio. Tipo de tomacorriente.

voltage

Voltage

Obligatorio. Voltaje de la fuente de alimentación.

amperes

Amperes

Obligatorio. Amperios de la fuente de alimentación.

Amperios

Valores de amperios válidos.

Enums
AMPERES_UNSPECIFIED No se especificó el amperaje.
AMPERES_15 15A.

NetworkUplinkType

Son los tipos de enlace de subida de red válidos.

Enums
RJ_45 RJ-45

PowerReceptacleType

Son los tipos de tomacorrientes válidos.

Enums
POWER_RECEPTACLE_TYPE_UNSPECIFIED No se especificó el tipo de enchufe de la instalación.
NEMA_5_15 NEMA 5-15.
C_13 C13.
STANDARD_EU

Obsoleto: Usa TYPE_G_BS1363, CEE_7_3, CEE_7_5 o TYPE_F en su lugar.

TYPE_G_BS1363 Tipo G / BS1363.
CEE_7_3 C 7/3.
CEE_7_5 C 7/5.
TYPE_F Tipo F.

Voltaje

Valores de voltaje válidos.

Enums
VOLTAGE_UNSPECIFIED No se especificó el voltaje.
VOLTAGE_110 120 V
VOLTAGE_220 220 V

ListChangeLogEntriesRequest

Es una solicitud para enumerar las entradas del registro de cambios.

Campos
parent

string

Obligatorio. Es el orden en el que se deben enumerar las entradas del registro de cambios. Formato: projects/{project}/locations/{location}/orders/{order}

page_size

int32

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

page_token

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.

filter

string

Es opcional. Condición de filtrado. Consulta AIP-160.

order_by

string

Es opcional. Es una sugerencia sobre cómo ordenar los resultados.

ListChangeLogEntriesResponse

Es una lista de entradas del registro de cambios.

Campos
change_log_entries[]

ChangeLogEntry

Es la lista de entradas del registro de cambios.

next_page_token

string

Un token que identifica una página de resultados que el servidor debe devolver.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListCommentsRequest

Es una solicitud para enumerar comentarios.

Campos
parent

string

Obligatorio. Es el orden en el que se mostrarán los comentarios. Formato: projects/{project}/locations/{location}/orders/{order}

page_size

int32

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

page_token

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.

filter

string

Es opcional. Condición de filtrado. Consulta AIP-160.

order_by

string

Es opcional. Es una sugerencia sobre cómo ordenar los resultados.

ListCommentsResponse

Es una solicitud para enumerar comentarios.

Campos
comments[]

Comment

Es la lista de comentarios.

next_page_token

string

Un token que identifica una página de resultados que el servidor debe devolver.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListHardwareGroupsRequest

Es una solicitud para enumerar grupos de hardware.

Campos
parent

string

Obligatorio. Es el orden en el que se enumeran los grupos de hardware. Formato: projects/{project}/locations/{location}/orders/{order}

page_size

int32

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

page_token

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.

filter

string

Es opcional. Condición de filtrado. Consulta AIP-160.

order_by

string

Es opcional. Es una sugerencia sobre cómo ordenar los resultados.

ListHardwareGroupsResponse

Es una lista de grupos de hardware.

Campos
hardware_groups[]

HardwareGroup

Es la lista de grupos de hardware.

next_page_token

string

Un token que identifica una página de resultados que el servidor debe devolver.

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

ListHardwareRequest

Es una solicitud para enumerar hardware.

Campos
parent

string

Obligatorio. Es el proyecto y la ubicación en los que se enumerará el hardware. Formato: projects/{project}/locations/{location}

Para enumerar el hardware en todas las ubicaciones, sustituye - (el carácter de guion o guion corto) por la ubicación y verifica el campo unreachable en el mensaje de respuesta.

page_size

int32

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

page_token

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.

filter

string

Es opcional. Condición de filtrado. Consulta AIP-160.

order_by

string

Es opcional. Es una sugerencia sobre cómo ordenar los resultados.

ListHardwareResponse

Es una lista de hardware.

Campos
hardware[]

Hardware

Es la lista de hardware.

next_page_token

string

Un token que identifica una página de resultados que el servidor debe devolver.

unreachable[]

string

Ubicaciones a las que no se pudo llegar. Solo se usa para las búsquedas en la ubicación comodín -. Si no está vacío, indica que los resultados están incompletos.

ListOrdersRequest

Es una solicitud para enumerar pedidos.

Campos
parent

string

Obligatorio. Es el proyecto y la ubicación en los que se enumerarán los pedidos. Formato: projects/{project}/locations/{location}

Para enumerar los pedidos en todas las ubicaciones, sustituye - (el carácter de guion o guion corto) por la ubicación y verifica el campo unreachable en el mensaje de respuesta.

page_size

int32

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

page_token

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.

filter

string

Es opcional. Condición de filtrado. Consulta AIP-160.

order_by

string

Es opcional. Es una sugerencia sobre cómo ordenar los resultados.

ListOrdersResponse

Es una lista de pedidos.

Campos
orders[]

Order

Es la lista de pedidos.

next_page_token

string

Un token que identifica una página de resultados que el servidor debe devolver.

unreachable[]

string

Ubicaciones a las que no se pudo llegar. Solo se usa para las búsquedas en la ubicación comodín -. Si no está vacío, indica que los resultados están incompletos.

ListSitesRequest

Es una solicitud para enumerar sitios.

Campos
parent

string

Obligatorio. Es el proyecto y la ubicación en los que se enumerarán los sitios. Formato: projects/{project}/locations/{location}

Para enumerar los sitios en todas las ubicaciones, sustituye - (el carácter de guion o guion corto) por la ubicación y verifica el campo de inaccesibilidad en el mensaje de respuesta.

page_size

int32

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

page_token

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.

filter

string

Es opcional. Condición de filtrado. Consulta AIP-160.

order_by

string

Es opcional. Es una sugerencia sobre cómo ordenar los resultados.

ListSitesResponse

Es una lista de sitios.

Campos
sites[]

Site

Es la lista de sitios.

next_page_token

string

Un token que identifica una página de resultados que el servidor debe devolver.

unreachable[]

string

Ubicaciones a las que no se pudo llegar. Solo se usa para las búsquedas en la ubicación comodín -. Si no está vacío, indica que los resultados están incompletos.

ListSkusRequest

Es una solicitud para enumerar SKUs.

Campos
parent

string

Obligatorio. Es el proyecto y la ubicación en los que se enumerarán los SKUs. Formato: projects/{project}/locations/{location}

Para enumerar los SKU en todas las ubicaciones, sustituye - (el carácter de guion o guion corto) por la ubicación y verifica el campo unreachable en el mensaje de respuesta.

page_size

int32

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

page_token

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.

filter

string

Es opcional. Condición de filtrado. Consulta AIP-160.

order_by

string

Es opcional. Es una sugerencia sobre cómo ordenar los resultados.

ListSkusResponse

Es una lista de SKUs.

Campos
skus[]

Sku

Es la lista de SKUs.

next_page_token

string

Un token que identifica una página de resultados que el servidor debe devolver.

unreachable[]

string

Ubicaciones a las que no se pudo llegar. Solo se usa para las búsquedas en la ubicación comodín -. Si no está vacío, indica que los resultados están incompletos.

ListZonesRequest

Es una solicitud para enumerar zonas.

Campos
parent

string

Obligatorio. Es el proyecto y la ubicación en los que se enumerarán las zonas. Formato: projects/{project}/locations/{location}

Para enumerar las zonas en todas las ubicaciones, sustituye - (el carácter de guion o guion corto) por la ubicación y verifica el campo inalcanzable en el mensaje de respuesta.

page_size

int32

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.

page_token

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.

filter

string

Es opcional. Condición de filtrado. Consulta AIP-160.

order_by

string

Es opcional. Es una sugerencia sobre cómo ordenar los resultados.

ListZonesResponse

Es una lista de zonas.

Campos
zones[]

Zone

Es la lista de zonas.

next_page_token

string

Un token que identifica una página de resultados que el servidor debe devolver.

unreachable[]

string

Ubicaciones a las que no se pudo llegar. Solo se usa para las búsquedas en la ubicación comodín -. Si no está vacío, indica que los resultados están incompletos.

OperationMetadata

Representa los metadatos de una operación de larga duración.

Campos
create_time

Timestamp

Es solo de salida. Indica la hora a la que se creó la operación.

end_time

Timestamp

Es solo de salida. Indica la hora a la que finalizó la operación.

target

string

Es solo de salida. Indica la ruta de acceso al recurso definida por el servidor para el destino de la operación.

verb

string

Solo salida. Verbo que ejecuta la operación.

status_message

string

Es solo de salida. Indica el estado legible por humanos de la operación, si corresponde.

requested_cancellation

bool

Es solo de salida. Identifica si el usuario solicitó la cancelación de la operación. Las operaciones que se cancelaron de forma correcta tienen el valor [Operation.error][] con un google.rpc.Status.code de 1, que corresponde a Code.CANCELLED.

api_version

string

Es solo de salida. Indica la versión de la API que se usó para iniciar la operación.

Pedido

Es un pedido de hardware de GDC.

Campos
name

string

Es el identificador. Nombre de este pedido. Formato: projects/{project}/locations/{location}/orders/{order}

display_name

string

Es opcional. Es el nombre visible de este pedido.

create_time

Timestamp

Solo salida. Fecha y hora en que se creó este pedido.

update_time

Timestamp

Solo salida. Fecha y hora en que se actualizó este pedido por última vez.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este pedido como pares clave-valor. Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

state

State

Solo salida. Es el estado de este pedido. Cuando se cree el pedido, el estado se establecerá en BORRADOR.

organization_contact

OrganizationContact

Obligatorio. Información de contacto del cliente

target_workloads[]

string

Es opcional. Son las cargas de trabajo específicas del cliente que son de interés y a las que se dirige este pedido. Debe contener hasta 20 elementos, y la longitud de cada uno debe ser de hasta 50 caracteres.

customer_motivation

string

Es opcional. Es la información sobre la motivación del cliente para realizar este pedido. La longitud de este campo debe ser menor o igual a 1,000 caracteres.

fulfillment_time
(deprecated)

Timestamp

Es opcional. Obsoleto: Usa customer_requested_installation_date en su lugar.

customer_requested_installation_date

Date

Es opcional. Es la fecha de instalación que solicitó el cliente para este pedido.

region_code

string

Obligatorio. Código de región CLDR de Unicode en el que se implementará este pedido. Para obtener una lista de los códigos de región de CLDR válidos, consulta el Registro de etiquetas secundarias de idioma.

order_form_uri

string

Solo salida. Vínculo al formulario de pedido

type

Type

Solo salida. Es el tipo de este pedido.

submit_time

Timestamp

Solo salida. Es la fecha y hora en que se envió el pedido. Se propaga automáticamente con la hora actual cuando se envía un pedido.

billing_id

string

Solo salida. Es el ID de facturación de Google Cloud al que se le cobrará este pedido.

existing_hardware[]

HardwareLocation

Es opcional. Es el hardware existente que se quitará como parte de este pedido. Nota: Todo el hardware que se quite se reciclará, a menos que se acuerde lo contrario.

deployment_type

DeploymentType

Solo salida. Es el tipo de implementación de este pedido.

actual_installation_date

Date

Solo salida. Fecha de instalación real de este pedido.

estimated_installation_date

Date

Solo salida. Fecha de instalación estimada para este pedido.

estimated_delivery_date

Date

Solo salida. Es la fecha de entrega estimada de este pedido.

migration

bool

Es opcional. Indica si este pedido es una migración de la infraestructura existente del cliente.

accepted_time

Timestamp

Solo salida. Es la fecha y hora en que el pedido pasó al estado ACCEPTED.

requested_date_change

Date

Solo salida. Es la fecha en la que el cliente o Google quieren establecer la fecha de instalación programada.

vendor_notes

string

Solo salida. Notas sobre este pedido, proporcionadas por el proveedor.

vendor_contact

OrganizationContact

Solo salida. Es la información de contacto del SI asignado a este pedido.

ai_capable

bool

Solo salida. Indica si este pedido es para hardware compatible con Gemini en el software de GDC. Se completa automáticamente cuando se envía el pedido correctamente.

DeploymentType

Son los tipos válidos de una implementación.

Enums
DEPLOYMENT_TYPE_UNSPECIFIED No se especificó el tipo de Deployment.
FULL_PRODUCTION Implementación de prod con SLOs
PROOF_OF_CONCEPT Deployment con asistencia según el criterio del mejor esfuerzo y sin SLO.
INTERNAL Es una implementación interna con asistencia según el criterio del mejor esfuerzo y sin SLO.
CUSTOMER_LAB Implementación de lab del cliente que admitimos como si fuera de producción.

Estado

Estados válidos de un pedido.

Enums
STATE_UNSPECIFIED El estado del pedido no está especificado.
DRAFT El cliente está redactando el pedido y aún no lo envió.
SUBMITTED Se envió el pedido a Google.
INFO_COMPLETE Se completó toda la información que se requiere del cliente para completar el pedido.
ACCEPTED Google aceptó el pedido.
ADDITIONAL_INFO_NEEDED El pedido necesita más información del cliente.
BUILDING Google comenzó a fabricar el hardware del pedido.
SHIPPING El hardware se fabricó y se está enviando.
INSTALLING Se está instalando el hardware.
FAILED Se produjo un error al procesar el pedido y se requiere la intervención del cliente.
PARTIALLY_COMPLETED Se completó parcialmente el pedido, es decir, se entregó e instaló parte del hardware.
COMPLETED Se completó el pedido.
CANCELLED Se canceló el pedido.

Tipo

Son los tipos válidos de un pedido.

Enums
TYPE_UNSPECIFIED No se especificó el tipo de pedido.
PAID El cliente pagó.
POC Prueba de concepto para el cliente
UNPAID No se facturó.

OrganizationContact

Es la información de contacto de la organización del cliente.

Campos
address

PostalAddress

Obligatorio. Dirección de la organización.

email

string

Es opcional. Es el correo electrónico de la organización.

phone

string

Es opcional. Es el número de teléfono de la organización.

contacts[]

Contact

Obligatorio. Son los puntos de contacto individuales de la organización en esta ubicación.

PowerSupply

Son las opciones de fuente de alimentación.

Enums
POWER_SUPPLY_UNSPECIFIED No se especificó la fuente de alimentación.
POWER_SUPPLY_AC Fuente de alimentación de CA.
POWER_SUPPLY_DC Fuente de alimentación de CC.

RackSpace

Representa el espacio contiguo en un rack.

Campos
start_rack_unit

int32

Obligatorio. Primera unidad de bastidores del espacio de bastidores (inclusive).

end_rack_unit

int32

Obligatorio. Última unidad de bastidores del espacio de bastidores (inclusive)

RecordActionOnCommentRequest

Es una solicitud para registrar una acción en un comentario.

Campos
name

string

Obligatorio. Es el nombre del comentario. Formato: projects/{project}/locations/{location}/orders/{order}/comments/{comment}

action_type

ActionType

Obligatorio. Es el tipo de acción de la acción registrada.

ActionType

Son los tipos de acción válidos de Comment.

Enums
ACTION_TYPE_UNSPECIFIED La acción no se especifica.
READ Marcar comentario como leído
UNREAD Marcar comentario como no leído

RequestOrderDateChangeRequest

Es una solicitud para cambiar la fecha solicitada de un pedido.

Campos
name

string

Obligatorio. Es el nombre del pedido que se actualizará. Formato: projects/{project}/locations/{location}/orders/{order}

requested_date

Date

Obligatorio. Es la fecha en la que el cliente o Google quieren establecer la fecha de instalación programada.

SignalZoneStateRequest

Es una solicitud para indicar el estado de una zona.

Campos
name

string

Obligatorio. Es el nombre de la zona. Formato: projects/{project}/locations/{location}/zones/{zone}

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

state_signal

StateSignal

Es opcional. Es el indicador de estado que se enviará para esta zona. Se debe establecer state_signal o provisioning_state_signal, pero no ambos.

provisioning_state_signal

ProvisioningStateSignal

Es opcional. Es el indicador del estado de aprovisionamiento que se enviará para esta zona. Se debe establecer state_signal o provisioning_state_signal, pero no ambos.

step

string

Es opcional. Es el paso que se está ejecutando. Proporciona un estado más detallado cuando state_signal es FACTORY_TURNUP_CHECKS_STARTED o FACTORY_TURNUP_CHECKS_FAILED.

details

string

Es opcional. Son detalles adicionales, como un mensaje de error cuando state_signal es FACTORY_TURNUP_CHECKS_FAILED.

ProvisioningStateSignal

Son indicadores de estado de aprovisionamiento válidos para una zona.

Enums
PROVISIONING_STATE_SIGNAL_UNSPECIFIED No se especificó el indicador de estado de aprovisionamiento.
PROVISIONING_IN_PROGRESS El aprovisionamiento está en curso.
PROVISIONING_COMPLETE Se completó el aprovisionamiento.

StateSignal

Son los indicadores de estado válidos para una zona.

Enums
STATE_SIGNAL_UNSPECIFIED No se especifica el estado de la zona.
FACTORY_TURNUP_CHECKS_STARTED Comenzaron las verificaciones de puesta en marcha de la fábrica.
FACTORY_TURNUP_CHECKS_PASSED La zona está lista para la activación del sitio.
READY_FOR_SITE_TURNUP

La zona está lista para la activación del sitio. Obsoleto, pero no borrado.

FACTORY_TURNUP_CHECKS_FAILED La zona no pasó las verificaciones de activación de fábrica.
VERIFY_CLUSTER_INTENT_PRESENCE Verifica que haya una intención de clúster válida.

Sitio

Es un sitio físico en el que se instalará el hardware.

Campos
name

string

Es el identificador. Es el nombre del sitio. Formato: projects/{project}/locations/{location}/sites/{site}

display_name

string

Es opcional. Es el nombre visible de este sitio.

description

string

Es opcional. Descripción de este Sitio

create_time

Timestamp

Solo salida. Fecha y hora en que se creó este sitio.

update_time

Timestamp

Solo salida. Fecha y hora en que se actualizó este sitio por última vez.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a este sitio como pares clave-valor. Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

organization_contact

OrganizationContact

Obligatorio. Es la información de contacto de este sitio.

google_maps_pin_uri

string

Es opcional. Es una URL a la ubicación de la dirección del sitio en Google Maps. Un valor de ejemplo es https://goo.gl/maps/xxxxxxxxx.

access_times[]

TimePeriod

Es opcional. Son los períodos en los que se puede acceder al sitio. Si este campo está vacío, se puede acceder al sitio en cualquier momento.

Google usa este campo para programar la instalación inicial y cualquier mantenimiento de hardware posterior. Puedes actualizar esta información en cualquier momento. Por ejemplo, si la instalación inicial se solicita fuera del horario de atención, pero el mantenimiento debe realizarse durante el horario de atención habitual, debes actualizar los horarios de acceso después de que se complete la instalación inicial.

notes

string

Es opcional. Son todas las notas adicionales para este sitio. Incluye información sobre lo siguiente: - Restricciones de seguridad o acceso - Reglamentaciones que afecten a los técnicos que visiten el sitio - Cualquier proceso o aprobación especial que se requiera para trasladar el equipo - Si habrá un representante disponible durante las visitas al sitio

customer_site_id

string

Es opcional. Es el identificador definido por el cliente para este sitio. Se puede usar para identificar el sitio en los sistemas propios del cliente.

SKU

Es un código de artículo (SKU) de hardware de GDC.

Campos
name

string

Es el identificador. Es el nombre de este SKU. Formato: projects/{project}/locations/{location}/skus/{sku}

display_name

string

Solo salida. Es el nombre visible de este SKU.

create_time

Timestamp

Solo salida. Fecha y hora en que se creó este SKU.

update_time

Timestamp

Solo salida. Fecha y hora en que se actualizó este SKU por última vez.

config

SkuConfig

Solo salida. Es la configuración de este SKU.

instances[]

SkuInstance

Solo salida. Son las instancias disponibles de este SKU. Este campo se debe usar para verificar la disponibilidad de un SKU.

description

string

Solo salida. Es la descripción de este SKU.

revision_id

string

Solo salida. Es el ID de revisión del SKU. Se crea una revisión nueva cada vez que se actualiza config. El formato es una cadena hexadecimal de 8 caracteres.

is_active

bool

Solo salida. Es una marca que indica si esta revisión está activa o no. Solo se puede usar una revisión activa en un pedido nuevo.

type

Type

Solo salida. Es el tipo de este SKU.

vcpu_count

int32

Solo salida. Es el recuento de CPU virtuales asociadas a este SKU.

hardware_count_ranges[]

Range

Solo salida. Son los rangos inclusivos de recuentos de hardware que se permiten en una zona con este SKU.

Rango

Es el rango inclusivo.

Campos
min

int32

Es el valor mínimo del rango.

max

int32

Es el valor máximo del rango.

Tipo

Son los tipos válidos de un SKU.

Enums
TYPE_UNSPECIFIED No se especificó el tipo de SKU. Este no es un valor permitido.
RACK Es el SKU del rack.
SERVER Es el SKU del servidor.

SkuConfig

Es la configuración de un SKU.

Campos
cpu

string

Es información sobre la configuración de la CPU.

gpu

string

Es información sobre la configuración de la GPU.

ram

string

Es información sobre la configuración de la RAM.

storage

string

Es información sobre la configuración del almacenamiento.

SkuInstance

Es una instancia específica del SKU.

Campos
region_code

string

Es el código de región CLDR de Unicode en el que está disponible esta instancia.

power_supply

PowerSupply

Tipo de fuente de alimentación para esta instancia.

billing_sku

string

Es una referencia al SKU correspondiente en la API de Cloud Billing. La información de precios estimados se puede recuperar con esa API. Formato: services/{service}/skus/{sku}

billing_sku_per_vcpu

string

Es la referencia al SKU correspondiente por CPU virtual en la API de Cloud Billing. La información de precios estimados se puede recuperar con esa API. Formato: services/{service}/skus/{sku}

subscription_duration_months

int32

Es la duración de la suscripción del hardware en meses.

SubmitOrderRequest

Es una solicitud para enviar un pedido.

Campos
name

string

Obligatorio. Es el nombre del pedido. Formato: projects/{project}/locations/{location}/orders/{order}

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

type

Type

Es opcional. Es el tipo de esta solicitud. Si no se configura, se supone que el tipo de solicitud es INFO_PENDING.

Tipo

Son los tipos válidos de solicitud de envío de pedido.

Enums
TYPE_UNSPECIFIED No se especificó el tipo de solicitud. No debe usarse.
INFO_PENDING Usa este tipo de solicitud para enviar tu pedido e iniciar una conversación con Google. Después de enviar el pedido, no podrás modificar la cantidad ni el SKU del hardware. Ten en cuenta que este pedido no estará listo para su cumplimiento hasta que proporciones más información, como la configuración de la red de la zona, la información física y de instalación del hardware, etcétera. Si envías un pedido para un tipo de SKU de RACK, usa este tipo de solicitud, ya que se requerirá información adicional fuera de la API.
INFO_COMPLETE Usa este tipo de solicitud cuando estés listo para enviar tu pedido para su procesamiento. Además de la información requerida para INFO_PENDING, el pedido debe contener toda la información obligatoria, como la configuración de la red de zonas, la información física y de instalación del hardware, etcétera. Ya no se permitirán más cambios en la información del pedido.

Subred

Representa una subred.

Campos
address_range

string

Obligatorio. Es el rango de direcciones de esta subred en notación CIDR.

default_gateway_ip_address

string

Obligatorio. Es la puerta de enlace predeterminada para esta subred.

SubscriptionConfig

Es un mensaje para almacenar la configuración de una suscripción.

Campos
subscription_id

string

Solo salida. Es el identificador único de la suscripción.

billing_id

string

Solo salida. Es el ID de la Facturación de Google Cloud con el que se creó la suscripción.

state

SubscriptionState

Solo salida. Es el estado actual de la suscripción.

SubscriptionState

Es una enumeración que representa el estado de la suscripción.

Enums
SUBSCRIPTION_STATE_UNSPECIFIED El estado no se especifica.
ACTIVE El estado activo significa que la suscripción se creó correctamente y se está facturando.
INACTIVE Inactiva significa que la suscripción se creó correctamente, pero la facturación aún no comenzó.
ERROR La suscripción se encuentra en un estado erróneo.
FAILED_TO_RETRIEVE No se pudo recuperar el estado de la suscripción. Este puede ser un problema transitorio. El usuario debe volver a enviar la solicitud.
COMPLETED Se completó la suscripción porque se alcanzó la fecha de finalización.

TimePeriod

Representa un período en una semana.

Campos
start_time

TimeOfDay

Obligatorio. Es el inicio del período.

end_time

TimeOfDay

Obligatorio. Es el final del período.

days[]

DayOfWeek

Obligatorio. Son los días de la semana en los que el período está activo.

UpdateHardwareGroupRequest

Es una solicitud para actualizar un grupo de hardware.

Campos
update_mask

FieldMask

Obligatorio. Es una máscara para especificar los campos de HardwareGroup que se reemplazarán con esta actualización. Los campos especificados en update_mask se relacionan con el grupo de hardware, no con la solicitud completa. Un campo se reemplazará si está en la máscara. Si no proporcionas una máscara, se reemplazarán todos los campos.

hardware_group

HardwareGroup

Obligatorio. Es el grupo de hardware que se actualizará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

UpdateHardwareRequest

Es una solicitud para actualizar el hardware.

Campos
update_mask

FieldMask

Obligatorio. Es una máscara para especificar los campos del hardware que se reemplazarán con esta actualización. Los campos especificados en update_mask se relacionan con el hardware, no con la solicitud completa. Un campo se reemplazará si está en la máscara. Si no proporcionas una máscara, se reemplazarán todos los campos.

hardware

Hardware

Obligatorio. Es el hardware que se actualizará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

UpdateOrderRequest

Es una solicitud para actualizar un pedido.

Campos
update_mask

FieldMask

Obligatorio. Es una máscara para especificar los campos del pedido que se reemplazarán con esta actualización. Los campos especificados en update_mask se relacionan con el pedido, no con la solicitud completa. Un campo se reemplazará si está en la máscara. Si no proporcionas una máscara, se reemplazarán todos los campos.

order

Order

Obligatorio. Es el pedido que se actualizará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

UpdateSiteRequest

Es una solicitud para actualizar un sitio.

Campos
update_mask

FieldMask

Obligatorio. Es una máscara para especificar los campos del sitio que se reemplazarán con esta actualización. Los campos especificados en update_mask se relacionan con el sitio, no con la solicitud completa. Un campo se reemplazará si está en la máscara. Si no proporcionas una máscara, se reemplazarán todos los campos.

site

Site

Obligatorio. Es el sitio que se actualizará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

UpdateZoneRequest

Es una solicitud para actualizar una zona.

Campos
update_mask

FieldMask

Obligatorio. Es una máscara para especificar los campos de la zona que se reemplazarán con esta actualización. Los campos especificados en update_mask se relacionan con la zona, no con la solicitud completa. Un campo se reemplazará si está en la máscara. Si no proporcionas una máscara, se reemplazarán todos los campos.

zone

Zone

Obligatorio. Es la zona que se actualizará.

request_id

string

Es opcional. Es un identificador único opcional para esta solicitud. Consulta AIP-155.

Zona

Es una zona que contiene un conjunto de hardware.

Campos
name

string

Es el identificador. Es el nombre de esta zona. Formato: projects/{project}/locations/{location}/zones/{zone}

create_time

Timestamp

Solo salida. Fecha y hora en que se creó esta zona.

update_time

Timestamp

Solo salida. Fecha y hora en que se actualizó esta zona por última vez.

labels

map<string, string>

Es opcional. Son las etiquetas asociadas a esta zona como pares clave-valor. Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

display_name

string

Es opcional. Nombre visible descriptivo de esta zona.

state

State

Solo salida. Es el estado actual de esta zona.

contacts[]

Contact

Obligatorio. Puntos de contacto de la zona (nombre, correo electrónico y teléfono). Dependiente del orden: El primer contacto de la lista es el principal, el segundo es el secundario, etcétera.

ciq_uri

string

Solo salida. Es el vínculo a la hoja del cuestionario de admisión del cliente (CIQ) para esta zona.

network_config

ZoneNetworkConfig

Es opcional. Es la configuración de redes para esta zona.

globally_unique_id

string

Solo salida. Es el identificador único a nivel global que se genera para esta zona perimetral.

subscription_configs[]

SubscriptionConfig

Solo salida. Son los parámetros de configuración de suscripción para esta zona.

provisioning_state

ProvisioningState

Solo salida. Es el estado de aprovisionamiento para configuraciones como las direcciones MAC.

skip_cluster_provisioning

bool

Es opcional. Indica si se debe omitir el paso de aprovisionamiento del clúster durante el encendido de fábrica. Si es verdadero, indica que el clúster de Kubernetes se creará después de que se instale el hardware de la zona en las instalaciones del cliente.

cluster_intent_required

bool

Solo salida. Indica si el cliente debe proporcionar una intención de clúster válida antes de aceptar el pedido. Si es verdadero, no se puede aceptar el pedido hasta que esté presente el intent del clúster. Se usa para aplicar la validación temprana y evitar retrasos causados por la falta de configuración.

cluster_intent_verified

bool

Solo salida. Indica si se verificó correctamente la intención de clúster proporcionada. Esta marca garantiza que exista el intent del clúster antes de que se pueda aceptar el pedido.

ai_capable

bool

Solo salida. Indica si esta zona es para el clúster de software de Gemini en GDC.

ProvisioningState

Son los estados de aprovisionamiento válidos para configuraciones como las direcciones MAC.

Enums
PROVISIONING_STATE_UNSPECIFIED El estado de aprovisionamiento no está especificado.
PROVISIONING_REQUIRED Se requiere aprovisionamiento. Google lo establece.
PROVISIONING_IN_PROGRESS El aprovisionamiento está en curso. Establecido por el cliente.
PROVISIONING_COMPLETE Se completó el aprovisionamiento. Establecido por el cliente.

Estado

Son los estados válidos para una zona.

Enums
STATE_UNSPECIFIED El estado de la zona no está especificado.
ADDITIONAL_INFO_NEEDED Se requiere más información del cliente para avanzar.
PREPARING Google está preparando la zona.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS La activación de fábrica se realizó correctamente.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED La zona está ejecutando verificaciones de encendido de fábrica.
READY_FOR_SITE_TURNUP La zona está lista para la activación del sitio.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED La zona no pasó las verificaciones de activación de fábrica.
ACTIVE La zona está disponible para su uso.
CANCELLED Se canceló la zona.

ZoneNetworkConfig

Es la configuración de red de una zona.

Campos
machine_mgmt_ipv4_range

string

Obligatorio. Es un bloque de direcciones IPv4 para la administración de máquinas. Debe ser un bloque CIDR privado RFC1918 o público lo suficientemente grande como para asignar al menos una dirección por máquina en la zona. Debe estar en management_ipv4_subnet y ser disjunto con otros rangos de direcciones.

kubernetes_node_ipv4_range

string

Obligatorio. Es un bloque de direcciones IPv4 para nodos de Kubernetes. Debe ser un bloque CIDR privado RFC1918 o público lo suficientemente grande como para asignar al menos una dirección por máquina en la zona. Debe estar en kubernetes_ipv4_subnet y ser disjunto con otros rangos de direcciones.

kubernetes_control_plane_ipv4_range

string

Obligatorio. Es un bloque de direcciones IPv4 para el plano de control de Kubernetes. Debe ser un bloque CIDR privado RFC1918 o público lo suficientemente grande como para asignar al menos una dirección por clúster en la zona. Debe estar en kubernetes_ipv4_subnet y ser disjunto con otros rangos de direcciones.

management_ipv4_subnet

Subnet

Obligatorio. Es una subred IPv4 para la red de administración.

kubernetes_ipv4_subnet

Subnet

Es opcional. Es una subred IPv4 para la red de Kubernetes. Si no se especifica, la subred de Kubernetes será la misma que la subred de administración.

dns_ipv4_addresses[]

string

Es opcional. Servidores de nombres DNS La infraestructura de GDC resolverá las consultas de DNS a través de estas IP. Si no se especifica, se usa el DNS de Google.

kubernetes_primary_vlan_id

int32

Es opcional. ID de VLAN de Kubernetes. De forma predeterminada, el nodo de Kubernetes, incluida la red principal de Kubernetes, se encuentra en la misma VLAN que la red de administración de máquinas. Para la segmentación de red, se pueden separar de forma opcional.