Package google.cloud.gdchardwaremanagement.v1alpha

Índice

GDCHardwareManagement

O serviço de gerenciamento de hardware do GDC.

CancelOrder

rpc CancelOrder(CancelOrderRequest) returns (Operation)

Cancela um pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.orders.submit

Para mais informações, consulte a documentação do IAM.

ChangeHardwareSubscription

rpc ChangeHardwareSubscription(ChangeHardwareSubscriptionRequest) returns (Operation)

Atualiza a configuração de assinatura de um hardware.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

CreateComment

rpc CreateComment(CreateCommentRequest) returns (Operation)

Cria um comentário em um pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.comments.create

Para mais informações, consulte a documentação do IAM.

CreateHardware

rpc CreateHardware(CreateHardwareRequest) returns (Operation)

Cria um novo hardware em um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.hardware.create

Para mais informações, consulte a documentação do IAM.

CreateHardwareGroup

rpc CreateHardwareGroup(CreateHardwareGroupRequest) returns (Operation)

Cria um novo grupo de hardware em um determinado pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.hardwareGroups.create

Para mais informações, consulte a documentação do IAM.

CreateOrder

rpc CreateOrder(CreateOrderRequest) returns (Operation)

Cria um pedido em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.orders.create

Para mais informações, consulte a documentação do IAM.

CreateSite

rpc CreateSite(CreateSiteRequest) returns (Operation)

Cria um novo site Google em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.sites.create

Para mais informações, consulte a documentação do IAM.

CreateZone

rpc CreateZone(CreateZoneRequest) returns (Operation)

Cria uma zona em determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.zones.create

Para mais informações, consulte a documentação do IAM.

CreateZoneOperation

rpc CreateZoneOperation(CreateZoneOperationRequest) returns (Operation)

Cria uma nova ZoneOperation em uma determinada zona.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

DeleteHardware

rpc DeleteHardware(DeleteHardwareRequest) returns (Operation)

Exclui o hardware.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.hardware.delete

Para mais informações, consulte a documentação do IAM.

DeleteHardwareGroup

rpc DeleteHardwareGroup(DeleteHardwareGroupRequest) returns (Operation)

Exclui um grupo de hardware.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.hardwareGroups.delete

Para mais informações, consulte a documentação do IAM.

DeleteOrder

rpc DeleteOrder(DeleteOrderRequest) returns (Operation)

Exclui um pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.orders.delete

Para mais informações, consulte a documentação do IAM.

DeleteSite

rpc DeleteSite(DeleteSiteRequest) returns (Operation)

Exclui um site.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.sites.delete

Para mais informações, consulte a documentação do IAM.

DeleteZone

rpc DeleteZone(DeleteZoneRequest) returns (Operation)

Exclui uma zona.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.zones.delete

Para mais informações, consulte a documentação do IAM.

DeleteZoneOperation

rpc DeleteZoneOperation(DeleteZoneOperationRequest) returns (Operation)

Exclui uma única ZoneOperation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

GetChangeLogEntry

rpc GetChangeLogEntry(GetChangeLogEntryRequest) returns (ChangeLogEntry)

Recebe detalhes de uma mudança em um pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.changeLogEntries.get

Para mais informações, consulte a documentação do IAM.

GetComment

rpc GetComment(GetCommentRequest) returns (Comment)

Recebe o conteúdo de um comentário.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.comments.get

Para mais informações, consulte a documentação do IAM.

GetHardware

rpc GetHardware(GetHardwareRequest) returns (Hardware)

Recebe detalhes do hardware.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.hardware.get

Para mais informações, consulte a documentação do IAM.

GetHardwareGroup

rpc GetHardwareGroup(GetHardwareGroupRequest) returns (HardwareGroup)

Recebe detalhes de um grupo de hardware.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.hardwareGroups.get

Para mais informações, consulte a documentação do IAM.

GetOrder

rpc GetOrder(GetOrderRequest) returns (Order)

Recebe detalhes de um pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.orders.get

Para mais informações, consulte a documentação do IAM.

GetSite

rpc GetSite(GetSiteRequest) returns (Site)

Recebe detalhes de um site.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.sites.get

Para mais informações, consulte a documentação do IAM.

GetSku

rpc GetSku(GetSkuRequest) returns (Sku)

Recebe detalhes de uma SKU.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.skus.get

Para mais informações, consulte a documentação do IAM.

GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

Recebe detalhes de uma zona.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.zones.get

Para mais informações, consulte a documentação do IAM.

GetZoneOperation

rpc GetZoneOperation(GetZoneOperationRequest) returns (ZoneOperation)

Recebe detalhes de uma única ZoneOperation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListChangeLogEntries

rpc ListChangeLogEntries(ListChangeLogEntriesRequest) returns (ListChangeLogEntriesResponse)

Lista as mudanças feitas em um pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.changeLogEntries.list

Para mais informações, consulte a documentação do IAM.

ListComments

rpc ListComments(ListCommentsRequest) returns (ListCommentsResponse)

Lista os comentários de um pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.comments.list

Para mais informações, consulte a documentação do IAM.

ListHardware

rpc ListHardware(ListHardwareRequest) returns (ListHardwareResponse)

Lista o hardware em um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.hardware.list

Para mais informações, consulte a documentação do IAM.

ListHardwareGroups

rpc ListHardwareGroups(ListHardwareGroupsRequest) returns (ListHardwareGroupsResponse)

Lista os grupos de hardware em um determinado pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.hardwareGroups.list

Para mais informações, consulte a documentação do IAM.

ListOrders

rpc ListOrders(ListOrdersRequest) returns (ListOrdersResponse)

Lista os pedidos em um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.orders.list

Para mais informações, consulte a documentação do IAM.

ListSites

rpc ListSites(ListSitesRequest) returns (ListSitesResponse)

Lista os sites em um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.sites.list

Para mais informações, consulte a documentação do IAM.

ListSkus

rpc ListSkus(ListSkusRequest) returns (ListSkusResponse)

Lista SKUs de um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.skus.list

Para mais informações, consulte a documentação do IAM.

ListZoneOperations

rpc ListZoneOperations(ListZoneOperationsRequest) returns (ListZoneOperationsResponse)

Lista ZoneOperations em um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

Lista as zonas em um determinado projeto e local.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.zones.list

Para mais informações, consulte a documentação do IAM.

RecordActionOnComment

rpc RecordActionOnComment(RecordActionOnCommentRequest) returns (Comment)

Registrar ação em um comentário. Se a ação especificada na solicitação for READ, o horário de visualização no comentário será definido como o horário em que a solicitação foi recebida. Se o comentário já estiver marcado como lido, as chamadas seguintes serão ignoradas. Se a ação for UNREAD, o horário de visualização será removido do comentário.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

RequestOrderDateChange

rpc RequestOrderDateChange(RequestOrderDateChangeRequest) returns (Operation)

Atualiza a mudança de data solicitada de um único pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.orders.update

Para mais informações, consulte a documentação do IAM.

SignalHardwareState

rpc SignalHardwareState(SignalHardwareStateRequest) returns (Operation)

Sinaliza o estado de um hardware.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.hardware.update

Para mais informações, consulte a documentação do IAM.

SignalZoneState

rpc SignalZoneState(SignalZoneStateRequest) returns (Operation)

Sinaliza o estado de uma zona.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.zones.update

Para mais informações, consulte a documentação do IAM.

SubmitOrder

rpc SubmitOrder(SubmitOrderRequest) returns (Operation)

Envia um pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.orders.submit

Para mais informações, consulte a documentação do IAM.

UpdateHardware

rpc UpdateHardware(UpdateHardwareRequest) returns (Operation)

Atualiza os parâmetros de hardware.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.hardware.update

Para mais informações, consulte a documentação do IAM.

UpdateHardwareGroup

rpc UpdateHardwareGroup(UpdateHardwareGroupRequest) returns (Operation)

Atualiza os parâmetros de um grupo de hardware.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.hardwareGroups.update

Para mais informações, consulte a documentação do IAM.

UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Operation)

Atualiza os parâmetros de um pedido.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.orders.update

Para mais informações, consulte a documentação do IAM.

UpdateSite

rpc UpdateSite(UpdateSiteRequest) returns (Operation)

Atualiza os parâmetros de um site.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.sites.update

Para mais informações, consulte a documentação do IAM.

UpdateZone

rpc UpdateZone(UpdateZoneRequest) returns (Operation)

Atualiza os parâmetros de uma zona.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gdchardwaremanagement.zones.update

Para mais informações, consulte a documentação do IAM.

UpdateZoneOperation

rpc UpdateZoneOperation(UpdateZoneOperationRequest) returns (Operation)

Atualiza os parâmetros de uma única ZoneOperation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

ValidateHardware

rpc ValidateHardware(ValidateHardwareRequest) returns (Operation)

Valida uma configuração de hardware fornecida como dados JSON. Esse método realiza verificações estáticas e não cria nem modifica recursos.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

BGPConfig

Configuração do protocolo de gateway de borda (BGP, na sigla em inglês).

Campos
asn

string

Obrigatório. Número de sistema autônomo (ASN, na sigla em inglês) do BGP.

l3_peer_ips[]

string

Obrigatório. IPs de peering do BGP. É necessário pelo menos dois IPs de peering L3.

CancelOrderRequest

Uma solicitação para cancelar um pedido.

Campos
name

string

Obrigatório. O nome do pedido. Formato: projects/{project}/locations/{location}/orders/{order}

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

Operadora

Lista de operadoras.

Tipos enumerados
CARRIER_UNSPECIFIED Operadora não especificada.
FEDEX Transportadora FedEx.
UPS UPS da operadora.
USPS Operadora USPS.

ChangeHardwareSubscriptionRequest

Uma solicitação para mudar a configuração de assinatura de um hardware.

Campos
name

string

Obrigatório. O nome do hardware a ser atualizado.

term_end_behavior

TermEndBehavior

Obrigatório. O comportamento da assinatura ao final do período.

TermEndBehavior

O comportamento ao fim da vigência da assinatura.

Tipos enumerados
TERM_END_BEHAVIOR_UNSPECIFIED O comportamento ao fim da vigência não foi especificado.
TERMINATE_AT_TERM_END O comportamento ao fim da vigência é TERMINATE_AT_TERM_END.

ChangeLogEntry

Uma entrada de registro de uma mudança feita em um pedido.

Campos
name

string

Identificador. Nome desta entrada de registro de alterações. Formato: projects/{project}/locations/{location}/orders/{order}/changeLogEntries/{change_log_entry}

create_time

Timestamp

Apenas saída. Hora em que esta entrada de registro de alterações foi criada.

labels

map<string, string>

Opcional. Rótulos associados a essa entrada de registro de alterações como pares de chave-valor. Para mais informações sobre rótulos, consulte Criar e gerenciar rótulos.

log

string

Apenas saída. Conteúdo desta entrada de registro.

Comentário

Um comentário em um pedido.

Campos
name

string

Identificador. Nome deste comentário. Formato: projects/{project}/locations/{location}/orders/{order}/comments/{comment}

create_time

Timestamp

Apenas saída. A data e a hora em que o comentário foi criado.

labels

map<string, string>

Opcional. Rótulos associados a este comentário como pares de chave-valor. Para mais informações sobre rótulos, consulte Criar e gerenciar rótulos.

author

string

Apenas saída. Nome de usuário do autor do comentário. Isso é preenchido automaticamente com as credenciais usadas durante a criação do comentário.

text

string

Obrigatório. Texto do comentário. O texto precisa ter no máximo 1.000 caracteres.

customer_viewed_time

Timestamp

Apenas saída. Carimbo de data/hora da primeira vez que o comentário foi visualizado pelo cliente. Se o comentário não tiver sido visualizado, esse carimbo de data/hora não será definido.

author_entity

Entity

Apenas saída. A entidade à qual o autor pertence.

Contato

Detalhes de contato de um ponto de contato.

Campos
given_name

string

Obrigatório. Nome do contato.

family_name

string

Opcional. Sobrenome do contato.

email

string

Opcional. E-mail principal do contato.

email_list[]

string

Opcional. Lista completa dos e-mails do contato (incluindo o e-mail principal).

phone

string

Opcional. Número de telefone do contato.

time_zone

TimeZone

Opcional. Fuso horário do contato.

reachable_times[]

TimePeriod

Opcional. Os períodos em que o contato está disponível. Se esse campo estiver vazio, o contato poderá ser acessado a qualquer momento.

notes

string

Opcional. Observações em formato livre detalhando como o contato quer ser notificado. Por exemplo, eles podem ter um método de contato preferido ou querer receber cópias de todos os encaminhamentos subsequentes.

CreateCommentRequest

Uma solicitação para criar um comentário.

Campos
parent

string

Obrigatório. O pedido em que o comentário será criado. Formato: projects/{project}/locations/{location}/orders/{order}

comment_id

string

Opcional. ID usado para identificar exclusivamente o comentário no escopo pai. Este campo precisa ter no máximo 63 caracteres e começar com caracteres minúsculos. Somente caracteres minúsculos, números e - são aceitos. O caractere - não pode ser o primeiro nem o último. Um ID gerado pelo sistema será usado se o campo não estiver definido.

O campo comment.name na solicitação será ignorado.

comment

Comment

Obrigatório. O comentário a ser criado.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

CreateHardwareGroupRequest

Uma solicitação para criar um grupo de hardware.

Campos
parent

string

Obrigatório. A ordem em que o grupo de hardware será criado. Formato: projects/{project}/locations/{location}/orders/{order}

hardware_group_id

string

Opcional. ID usado para identificar exclusivamente o HardwareGroup no escopo pai. Este campo precisa ter no máximo 63 caracteres e começar com caracteres minúsculos. Somente caracteres minúsculos, números e - são aceitos. O caractere - não pode ser o primeiro nem o último. Um ID gerado pelo sistema será usado se o campo não estiver definido.

O campo hardware_group.name na solicitação será ignorado.

hardware_group

HardwareGroup

Obrigatório. O grupo de hardware a ser criado.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

CreateHardwareRequest

Uma solicitação para criar hardware.

Campos
parent

string

Obrigatório. O projeto e o local em que o hardware será criado. Formato: projects/{project}/locations/{location}

hardware_id

string

Opcional. ID usado para identificar exclusivamente o hardware no escopo pai. Este campo precisa ter no máximo 63 caracteres e começar com caracteres minúsculos. Somente caracteres minúsculos, números e - são aceitos. O caractere - não pode ser o primeiro nem o último. Um ID gerado pelo sistema será usado se o campo não estiver definido.

O campo hardware.name na solicitação será ignorado.

hardware

Hardware

Obrigatório. O recurso a ser criado.

CreateOrderRequest

Uma solicitação para criar um pedido.

Campos
parent

string

Obrigatório. O projeto e o local em que o pedido será criado. Formato: projects/{project}/locations/{location}

order_id

string

Opcional. ID usado para identificar exclusivamente o pedido no escopo pai. Este campo precisa ter no máximo 63 caracteres e começar com caracteres minúsculos. Somente caracteres minúsculos, números e - são aceitos. O caractere - não pode ser o primeiro nem o último. Um ID gerado pelo sistema será usado se o campo não estiver definido.

O campo order.name na solicitação será ignorado.

order

Order

Obrigatório. O pedido a ser criado.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

CreateSiteRequest

Uma solicitação para criar um site.

Campos
parent

string

Obrigatório. O projeto e o local em que o site será criado. Formato: projects/{project}/locations/{location}

site_id

string

Opcional. ID usado para identificar de forma exclusiva o site no escopo pai. Este campo precisa ter no máximo 63 caracteres e começar com caracteres minúsculos. Somente caracteres minúsculos, números e - são aceitos. O caractere - não pode ser o primeiro nem o último. Um ID gerado pelo sistema será usado se o campo não estiver definido.

O campo site.name na solicitação será ignorado.

site

Site

Obrigatório. O site a ser criado.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

CreateZoneOperationRequest

Mensagem de solicitação para criar uma ZoneOperation.

Campos
parent

string

Obrigatório. A zona pai em que essa operação será criada. Formato: projects/{project}/locations/{location}/zones/{zone}

zone_operation_id

string

Opcional. ID usado para identificar exclusivamente a ZoneOperation no escopo pai. Este campo precisa ter no máximo 63 caracteres e começar com caracteres minúsculos. Somente caracteres minúsculos, números e - são aceitos. O caractere - não pode ser o primeiro nem o último. Um ID gerado pelo sistema será usado se o campo não estiver definido.

O campo zone_operation.name na solicitação será ignorado.

zone_operation

ZoneOperation

Obrigatório. A operação de zona a ser criada.

request_id

string

Opcional. Um ID de solicitação opcional para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se precisar repetir a solicitação, o servidor saberá que é preciso ignorar a solicitação se ela já tiver sido concluída. O servidor vai garantir isso por pelo menos 60 minutos após a primeira solicitação.

CreateZoneRequest

Uma solicitação para criar uma zona.

Campos
parent

string

Obrigatório. O projeto e o local em que a zona será criada. Formato: projects/{project}/locations/{location}

zone_id

string

Opcional. ID usado para identificar exclusivamente a zona no escopo pai. Este campo precisa ter no máximo 63 caracteres e começar com caracteres minúsculos. Somente caracteres minúsculos, números e - são aceitos. O caractere - não pode ser o primeiro nem o último. Um ID gerado pelo sistema será usado se o campo não estiver definido.

O campo zone.name na solicitação será ignorado.

zone

Zone

Obrigatório. A zona a ser criada.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

DeleteHardwareGroupRequest

Uma solicitação para excluir um grupo de hardware.

Campos
name

string

Obrigatório. O nome do grupo de hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

DeleteHardwareRequest

Uma solicitação para excluir hardware.

Campos
name

string

Obrigatório. O nome do hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

DeleteOrderRequest

Uma solicitação para excluir um pedido.

Campos
name

string

Obrigatório. O nome do pedido. Formato: projects/{project}/locations/{location}/orders/{order}

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

force

bool

Opcional. Uma opção para excluir todos os recursos aninhados no pedido, como um HardwareGroup. Se for verdadeiro, todos os recursos aninhados para este pedido também serão excluídos. Caso contrário, a solicitação só será bem-sucedida se o pedido não tiver recursos aninhados.

DeleteSiteRequest

Uma solicitação para excluir um site.

Campos
name

string

Obrigatório. É o nome do site. Formato: projects/{project}/locations/{location}/sites/{site}

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

DeleteZoneOperationRequest

Mensagem de solicitação para excluir uma ZoneOperation.

Campos
name

string

Obrigatório. Nome do recurso. Formato: projects/{project}/locations/{location}/zones/{zone}/ops/{zone_operation}

request_id

string

Opcional. Um ID de solicitação opcional para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se precisar repetir a solicitação, o servidor saberá que é preciso ignorar a solicitação se ela já tiver sido concluída. O servidor vai garantir isso por pelo menos 60 minutos após a primeira solicitação.

DeleteZoneRequest

Uma solicitação para excluir uma zona.

Campos
name

string

Obrigatório. O nome da zona. Formato: projects/{project}/locations/{location}/zones/{zone}

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

Dimensões

Representa as dimensões de um objeto.

Campos
width_inches

float

Obrigatório. Largura em polegadas.

height_inches

float

Obrigatório. Altura em polegadas.

depth_inches

float

Obrigatório. Profundidade em polegadas.

Entidade

"Entidade" é usado para indicar uma organização ou parte.

Tipos enumerados
ENTITY_UNSPECIFIED A entidade não foi especificada.
GOOGLE Google.
CUSTOMER Cliente.
VENDOR Fornecedor.

GetChangeLogEntryRequest

Uma solicitação para receber uma entrada de registro de alterações.

Campos
name

string

Obrigatório. O nome da entrada de registro de alterações. Formato: projects/{project}/locations/{location}/orders/{order}/changeLogEntries/{change_log_entry}

GetCommentRequest

Uma solicitação para receber um comentário.

Campos
name

string

Obrigatório. O nome do comentário. Formato: projects/{project}/locations/{location}/orders/{order}/comments/{comment}

GetHardwareGroupRequest

Uma solicitação para receber um grupo de hardware.

Campos
name

string

Obrigatório. O nome do grupo de hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

GetHardwareRequest

Uma solicitação para receber hardware.

Campos
name

string

Obrigatório. O nome do hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}

GetOrderRequest

Uma solicitação para receber um pedido.

Campos
name

string

Obrigatório. Nome do recurso

GetSiteRequest

Uma solicitação para receber um site.

Campos
name

string

Obrigatório. É o nome do site. Formato: projects/{project}/locations/{location}/sites/{site}

GetSkuRequest

Uma solicitação para receber uma SKU.

Campos
name

string

Obrigatório. O nome da SKU. Formato: projects/{project}/locations/{location}/skus/{sku}

GetZoneOperationRequest

Mensagem de solicitação para receber uma ZoneOperation.

Campos
name

string

Obrigatório. Nome do recurso. Formato: projects/{project}/locations/{location}/zones/{zone}/ops/{zone_operation}

GetZoneRequest

Uma solicitação para receber uma zona.

Campos
name

string

Obrigatório. O nome da zona. Formato: projects/{project}/locations/{location}/zones/{zone}

Hardware

Uma instância de hardware instalada em um local.

Campos
name

string

Identificador. Nome do hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}

display_name

string

Opcional. Nome de exibição do hardware.

create_time

Timestamp

Apenas saída. Hora em que o hardware foi criado.

update_time

Timestamp

Apenas saída. Hora em que o hardware foi atualizado pela última vez.

labels

map<string, string>

Opcional. Rótulos associados a este hardware como pares de chave-valor. Para mais informações sobre rótulos, consulte Criar e gerenciar rótulos.

order

string

Opcional. Nome do pedido a que esse hardware pertence. Formato: projects/{project}/locations/{location}/orders/{order}

hardware_group

string

Apenas saída. Nome do grupo de hardware ao qual o hardware pertence. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

site

string

Obrigatório. Nome do site ao qual esse hardware pertence. Formato: projects/{project}/locations/{location}/sites/{site}

state

State

Apenas saída. Estado atual do hardware.

ciq_uri

string

Apenas saída. Link para a planilha do Questionário de admissão do cliente (CIQ) para este hardware.

config

HardwareConfig

Obrigatório. Configuração para este hardware.

estimated_installation_date

Date

Apenas saída. Data de instalação estimada para este hardware.

physical_info

HardwarePhysicalInfo

Opcional. Propriedades físicas desse hardware.

installation_info

HardwareInstallationInfo

Opcional. Informações para instalação desse hardware.

zone

string

Obrigatório. Nome da zona a que o hardware pertence. Formato: projects/{project}/locations/{location}/zones/{zone}

requested_installation_date
(deprecated)

Date

Opcional. Descontinuado: a data de instalação solicitada foi movida para o recurso Pedido. Use customer_requested_installation_date no recurso Order.

actual_installation_date

Date

Apenas saída. Data de instalação real do hardware. Preenchido pelo Google.

machine_infos[]

MachineInfo

Opcional. Informações de recursos por máquina necessárias para a ativação.

estimated_delivery_date

Date

Apenas saída. A data de entrega estimada do hardware.

ai_capable

bool

Apenas saída. Indica se esse hardware é para o Gemini no software do GDC.

subscription_configs[]

SubscriptionConfig

Apenas saída. Configurações de assinatura para este hardware.

operations[]

ResourceOperation

Apenas saída. Lista de todas as operações realizadas no hardware.

errors[]

Status

Apenas saída. Os erros encontrados durante a ativação da intent de hardware. Os metadados de ErrorInfo vão incluir o carimbo de data/hora e se o erro pode ser repetido.

shipping_info

ShippingInfo

Apenas saída. Informações de envio para este hardware.

DiskInfo

Informações sobre discos individuais em uma máquina.

Campos
manufacturer

string

Opcional. Fabricante do disco.

slot

int32

Opcional. Número do slot do disco.

serial_number

string

Opcional. Número de série do disco.

psid

string

Opcional. PSID do disco.

part_number

string

Opcional. Número da peça do disco.

model_number

string

Opcional. Número do modelo do disco.

MacAddress

Mensagem para descrever o endereço MAC de uma máquina.

Campos
address

string

Apenas saída. String de endereço.

type

AddressType

Apenas saída. Tipo de endereço para este endereço MAC.

ipv4_address

string

Apenas saída. Endereço IP estático (se usado) associado ao endereço MAC. Aplicável apenas ao tipo de endereço MAC VIRTUAL.

AddressType

Tipo enumerado para os diferentes tipos de endereço MAC.

Tipos enumerados
ADDRESS_TYPE_UNSPECIFIED Tipo de endereço não especificado.
NIC Endereço de uma placa de rede.
BMC Endereço de um controlador de gerenciamento da placa-base.
VIRTUAL Endereço de uma interface virtual.

MachineInfo

Informações sobre máquinas individuais que os fornecedores vão fornecer durante a ativação.

Campos
service_tag

string

Opcional. Tag de serviço da máquina.

mac_addresses[]

MacAddress

Apenas saída. Cada endereço MAC associado.

name

string

Apenas saída. Nome da máquina.

disk_infos[]

DiskInfo

Opcional. Informações sobre cada disco instalado.

machine_type

MachineType

Opcional. Tipo de máquina. Obrigatório para hardware que executa o Gemini no software do GDC.

tpm_ek_cert_hash

string

Opcional. Hash do certificado EK do TPM. Obrigatório durante o conserto do hardware.

gpu_serial_numbers[]

string

Opcional. Números de série da GPU. Obrigatório durante o conserto do hardware.

cpu_serial_numbers[]

string

Opcional. Números de série da CPU. Obrigatório durante o conserto do hardware.

memory_infos[]

MemoryInfo

Opcional. Informações sobre cada memória instalada. Obrigatório durante o conserto do hardware.

idrac_mac_address

string

Opcional. Endereço MAC do iDRAC. Obrigatório durante o reparo do hardware.

nic_serial_numbers[]

string

Opcional. Números de série da NIC. Obrigatório durante o conserto do hardware.

MachineType

Tipo enumerado para tipos de máquina usados no Gemini no software do GDC.

Tipos enumerados
MACHINE_TYPE_UNSPECIFIED Tipo de máquina não especificado.
DELL_XE9680 Servidor Dell XE9680.
DELL_XE9780 Servidor Dell XE9780.

MemoryInfo

Informações sobre memórias individuais em uma máquina.

Campos
serial_number

string

Opcional. Número de série da memória.

size_bytes

int64

Opcional. Tamanho da memória.

part_number

string

Opcional. Número da peça da memória.

Estado

Estados válidos para hardware.

Tipos enumerados
STATE_UNSPECIFIED O estado do hardware não foi especificado.
ADDITIONAL_INFO_NEEDED O cliente precisa fornecer mais informações para que o processo continue.
BUILDING O Google iniciou a fabricação do hardware.
SHIPPING O hardware foi construído e está sendo enviado.
INSTALLING O hardware está sendo instalado.
INSTALLED O hardware foi instalado.
FAILED Ocorreu um erro, e a intervenção do cliente é necessária.
INFO_COMPLETE O hardware tem todas as informações necessárias.
READY_FOR_PROVISIONING O hardware está pronto para provisionamento.
PROVISIONING_STARTED O provisionamento do hardware foi iniciado.
PROVISIONING_FAILED Falha no provisionamento de hardware.
AWAITING_IDENTIFIERS Os identificadores do hardware precisam ser adicionados.
READY_FOR_BOOTSTRAP O hardware está pronto para inicialização.

HardwareConfig

Configuração do hardware do GDC.

Campos
sku

string

Obrigatório. Referência à SKU deste hardware. Isso pode apontar para uma revisão de SKU específica no formato resource_name@revision_id, conforme definido em AIP-162. Se nenhum revision_id for especificado, ele se referirá à revisão mais recente.

power_supply

PowerSupply

Obrigatório. Tipo de fonte de alimentação para este hardware.

subscription_duration_months

int32

Opcional. Duração da assinatura do hardware em meses.

auto_renewal

bool

Opcional. Indica se as assinaturas de hardware serão renovadas automaticamente no final do período. Pode ser definido quando a SKU selecionada é compatível com a renovação automática.

HardwareGroup

Um grupo de hardware que faz parte do mesmo pedido, tem a mesma SKU e é entregue no mesmo local.

Campos
name

string

Identificador. Nome deste grupo de hardware. Formato: projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

create_time

Timestamp

Apenas saída. Hora em que o grupo de hardware foi criado.

update_time

Timestamp

Apenas saída. Hora em que o grupo de hardware foi atualizado pela última vez.

labels

map<string, string>

Opcional. Rótulos associados a esse grupo de hardware como pares de chave-valor. Para mais informações sobre rótulos, consulte Criar e gerenciar rótulos.

hardware_count

int32

Obrigatório. Número de hardwares neste HardwareGroup.

config

HardwareConfig

Obrigatório. Configuração do hardware neste HardwareGroup.

site

string

Obrigatório. Nome do local em que o hardware deste HardwareGroup será entregue. Formato: projects/{project}/locations/{location}/sites/{site}

state

State

Apenas saída. Estado atual deste HardwareGroup.

zone

string

Opcional. Nome da zona a que o hardware neste HardwareGroup pertence. Formato: projects/{project}/locations/{location}/zones/{zone}

requested_installation_date
(deprecated)

Date

Opcional. Descontinuado: este valor não é usado. Em vez disso, use o campo requested_installation_date no recurso Order.

Estado

Estados válidos de um HardwareGroup.

Tipos enumerados
STATE_UNSPECIFIED O estado do HardwareGroup não foi especificado.
ADDITIONAL_INFO_NEEDED O cliente precisa fornecer mais informações para que o processo continue.
BUILDING O Google iniciou a criação de hardware para este HardwareGroup.
SHIPPING O hardware foi construído e está sendo enviado.
INSTALLING O hardware está sendo instalado.
PARTIALLY_INSTALLED Alguns hardwares no HardwareGroup foram instalados.
INSTALLED Todo o hardware no HardwareGroup foi instalado.
FAILED Ocorreu um erro, e a intervenção do cliente é necessária.

HardwareInstallationInfo

Informações para instalação de um hardware.

Campos
rack_location

string

Opcional. Localização do rack no site, por exemplo, andar 2, sala 201, linha 7, rack 3.

power_distance_meters

int32

Obrigatório. Distância da tomada em metros.

switch_distance_meters

int32

Obrigatório. Distância do switch de rede em metros.

rack_unit_dimensions

Dimensions

Opcional. Dimensões da unidade de rack.

rack_space

RackSpace

Opcional. Espaço de rack alocado para o hardware.

rack_type

RackType

Obrigatório. Tipo de rack.

RackType

Tipos de rack válidos.

Tipos enumerados
RACK_TYPE_UNSPECIFIED O tipo de rack não foi especificado.
TWO_POST Rack de dois postes.
FOUR_POST Rack de quatro postes.

HardwareLocation

Representa o local de um ou vários hardwares.

Campos
site

string

Obrigatório. Nome do local em que o hardware está presente. Formato: projects/{project}/locations/{location}/sites/{site}

rack_location

string

Obrigatório. Localização do rack no site, por exemplo, andar 2, sala 201, linha 7, rack 3.

rack_space[]

RackSpace

Opcional. Espaços ocupados pelo hardware no rack. Se não for definido, esse local será considerado o rack inteiro.

HardwarePhysicalInfo

Propriedades físicas de um hardware.

Campos
power_receptacle

PowerReceptacleType

Obrigatório. O tipo de receptáculo de energia.

voltage

Voltage

Obrigatório. Tensão da fonte de alimentação.

amperes

Amperes

Obrigatório. Amperagem da fonte de alimentação.

Amperes

Valores válidos de amperes.

Tipos enumerados
AMPERES_UNSPECIFIED A amperagem não foi especificada.
AMPERES_15 15A.

NetworkUplinkType

Tipos válidos de uplink de rede.

Tipos enumerados
RJ_45 RJ-45.

PowerReceptacleType

Tipos de receptáculo de energia válidos.

Tipos enumerados
POWER_RECEPTACLE_TYPE_UNSPECIFIED O tipo de tomada do local não foi especificado.
NEMA_5_15 NEMA 5-15.
C_13 C13.
STANDARD_EU

Descontinuado: use TYPE_G_BS1363, CEE_7_3, CEE_7_5 ou TYPE_F.

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

Tensão

Valores de tensão válidos.

Tipos enumerados
VOLTAGE_UNSPECIFIED A tensão não foi especificada.
VOLTAGE_110 120V.
VOLTAGE_220 220V.

ListChangeLogEntriesRequest

Uma solicitação para listar entradas de registro de alterações.

Campos
parent

string

Obrigatório. A ordem para listar as entradas de registro de alterações. Formato: projects/{project}/locations/{location}/orders/{order}

page_size

int32

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.

page_token

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.

filter

string

Opcional. Condição de filtragem. Consulte AIP-160 (em inglês).

order_by

string

Opcional. Dica de como organizar os resultados.

ListChangeLogEntriesResponse

Uma lista de entradas do registro de alterações.

Campos
change_log_entries[]

ChangeLogEntry

A lista de entradas de registro de alterações.

next_page_token

string

Um token que identifica a página de resultados que o servidor retornará.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados.

ListCommentsRequest

Uma solicitação para listar comentários.

Campos
parent

string

Obrigatório. O pedido em que os comentários serão listados. Formato: projects/{project}/locations/{location}/orders/{order}

page_size

int32

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.

page_token

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.

filter

string

Opcional. Condição de filtragem. Consulte AIP-160 (em inglês).

order_by

string

Opcional. Dica de como organizar os resultados.

ListCommentsResponse

Uma solicitação para listar comentários.

Campos
comments[]

Comment

A lista de comentários.

next_page_token

string

Um token que identifica a página de resultados que o servidor retornará.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados.

ListHardwareGroupsRequest

Uma solicitação para listar grupos de hardware.

Campos
parent

string

Obrigatório. A ordem em que os grupos de hardware serão listados. Formato: projects/{project}/locations/{location}/orders/{order}

page_size

int32

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.

page_token

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.

filter

string

Opcional. Condição de filtragem. Consulte AIP-160 (em inglês).

order_by

string

Opcional. Dica de como organizar os resultados.

ListHardwareGroupsResponse

Uma lista de grupos de hardware.

Campos
hardware_groups[]

HardwareGroup

A lista de grupos de hardware.

next_page_token

string

Um token que identifica a página de resultados que o servidor retornará.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados.

ListHardwareRequest

Uma solicitação para listar hardware.

Campos
parent

string

Obrigatório. O projeto e o local em que o hardware será listado. Formato: projects/{project}/locations/{location}

Para listar o hardware em todos os locais, substitua - (o caractere de hífen ou traço) pelo local e verifique o campo inacessível na mensagem de resposta.

page_size

int32

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.

page_token

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.

filter

string

Opcional. Condição de filtragem. Consulte AIP-160 (em inglês).

order_by

string

Opcional. Dica de como organizar os resultados.

ListHardwareResponse

Uma lista de hardware.

Campos
hardware[]

Hardware

A lista de hardware.

next_page_token

string

Um token que identifica a página de resultados que o servidor retornará.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados. Usado apenas para consultas ao local de caracteres curinga -. Se não estiver vazio, indica que os resultados estão incompletos.

ListOrdersRequest

Uma solicitação para listar pedidos.

Campos
parent

string

Obrigatório. O projeto e o local em que os pedidos serão listados. Formato: projects/{project}/locations/{location}

Para listar pedidos em todos os locais, substitua - (o caractere de hífen ou traço) pelo local e verifique o campo inacessível na mensagem de resposta.

page_size

int32

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.

page_token

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.

filter

string

Opcional. Condição de filtragem. Consulte AIP-160 (em inglês).

order_by

string

Opcional. Dica de como organizar os resultados.

ListOrdersResponse

Uma lista de pedidos.

Campos
orders[]

Order

A lista de pedidos.

next_page_token

string

Um token que identifica a página de resultados que o servidor retornará.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados. Usado apenas para consultas ao local de caracteres curinga -. Se não estiver vazio, indica que os resultados estão incompletos.

ListSitesRequest

Uma solicitação para listar sites.

Campos
parent

string

Obrigatório. O projeto e o local em que os sites serão listados. Formato: projects/{project}/locations/{location}

Para listar sites em todos os locais, substitua - (o caractere de hífen ou traço) pelo local e verifique o campo inacessível na mensagem de resposta.

page_size

int32

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.

page_token

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.

filter

string

Opcional. Condição de filtragem. Consulte AIP-160 (em inglês).

order_by

string

Opcional. Dica de como organizar os resultados.

ListSitesResponse

Uma lista de sites.

Campos
sites[]

Site

A lista de sites.

next_page_token

string

Um token que identifica a página de resultados que o servidor retornará.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados. Usado apenas para consultas ao local de caracteres curinga -. Se não estiver vazio, indica que os resultados estão incompletos.

ListSkusRequest

Uma solicitação para listar SKUs.

Campos
parent

string

Obrigatório. O projeto e o local em que as SKUs serão listadas. Formato: projects/{project}/locations/{location}

Para listar SKUs em todos os locais, substitua - (o caractere de hífen ou traço) pelo local e verifique o campo inacessível na mensagem de resposta.

page_size

int32

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.

page_token

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.

filter

string

Opcional. Condição de filtragem. Consulte AIP-160 (em inglês).

order_by

string

Opcional. Dica de como organizar os resultados.

ListSkusResponse

Uma lista de SKUs.

Campos
skus[]

Sku

A lista de SKUs.

next_page_token

string

Um token que identifica a página de resultados que o servidor retornará.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados. Usado apenas para consultas ao local de caracteres curinga -. Se não estiver vazio, indica que os resultados estão incompletos.

ListZoneOperationsRequest

Mensagem de solicitação para listar ZoneOperations.

Campos
parent

string

Obrigatório. Valor pai para ListZoneOperationsRequest. Formato: projects/{project}/locations/{location}/zones/{zone}

page_size

int32

Opcional. O número máximo de recursos a serem retornados. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.

page_token

string

Opcional. Um token de página recebido de uma chamada ListZoneOperations anterior. Forneça isso para recuperar a página subsequente.

filter

string

Opcional. Como filtrar resultados.

order_by

string

Opcional. Dica de como organizar os resultados.

ListZoneOperationsResponse

Mensagem de resposta para ListZoneOperations.

Campos
zone_operations[]

ZoneOperation

Os recursos da coleção especificada.

next_page_token

string

Um token, que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados.

ListZonesRequest

Uma solicitação para listar zonas.

Campos
parent

string

Obrigatório. O projeto e o local em que as zonas serão listadas. Formato: projects/{project}/locations/{location}

Para listar zonas em todos os locais, substitua - (o caractere de hífen ou traço) pelo local e verifique o campo inacessível na mensagem de resposta.

page_size

int32

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.

page_token

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.

filter

string

Opcional. Condição de filtragem. Consulte AIP-160 (em inglês).

order_by

string

Opcional. Dica de como organizar os resultados.

ListZonesResponse

Uma lista de zonas.

Campos
zones[]

Zone

A lista de zonas.

next_page_token

string

Um token que identifica a página de resultados que o servidor retornará.

unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados. Usado apenas para consultas ao local de caracteres curinga -. Se não estiver vazio, indica que os resultados estão incompletos.

OperationMetadata

Representa os metadados de uma operação de longa duração.

Campos
create_time

Timestamp

Somente saída: a hora em que a operação foi criada.

end_time

Timestamp

Somente saída: a hora em que a operação terminou de ser executada.

target

string

Apenas saída. Caminho do recurso definido pelo servidor para o destino da operação.

verb

string

Apenas saída. O verbo executado pela operação.

status_message

string

Apenas saída. Status legível por humanos da operação, caso haja um.

requested_cancellation

bool

Apenas saída. Identifica se o usuário solicitou o cancelamento da operação. As operações que foram canceladas têm o valor [Operation.error][] com um google.rpc.Status.code de 1, correspondente a Code.CANCELLED.

api_version

string

Apenas saída. Versão da API usada para iniciar a operação.

Pedido

Um pedido de hardware do GDC.

Campos
name

string

Identificador. Nome deste pedido. Formato: projects/{project}/locations/{location}/orders/{order}

display_name

string

Opcional. Nome de exibição deste pedido.

create_time

Timestamp

Apenas saída. A data e o horário em que o pedido foi criado.

update_time

Timestamp

Apenas saída. Hora em que o pedido foi atualizado pela última vez.

labels

map<string, string>

Opcional. Rótulos associados a este pedido como pares de chave-valor. Para mais informações sobre rótulos, consulte Criar e gerenciar rótulos.

state

State

Apenas saída. Estado deste pedido. Na criação do pedido, o estado será definido como RASCUNHO.

organization_contact

OrganizationContact

Opcional. Dados de contato do cliente. Opcional para pedidos que usam o Gemini no software do GDC, obrigatório em outros casos.

target_workloads[]

string

Opcional. Cargas de trabalho de interesse especificadas pelo cliente que são segmentadas por este pedido. Ele precisa conter no máximo 20 elementos, e cada um deles precisa ter no máximo 50 caracteres.

customer_motivation

string

Opcional. Informações sobre a motivação do cliente para esse pedido. O comprimento desse campo precisa ser <= 1.000 caracteres.

fulfillment_time
(deprecated)

Timestamp

Opcional. Descontinuado: use customer_requested_installation_date.

customer_requested_installation_date

Date

Opcional. Data de instalação solicitada pelo cliente para este pedido.

region_code

string

Obrigatório. Código de região Unicode CLDR em que o pedido será implantado. Para ver uma lista de códigos de região CLDR válidos, consulte o Registro de subtags de idioma.

order_form_uri

string

Apenas saída. Link para o formulário de pedido.

type

Type

Apenas saída. Tipo deste pedido.

submit_time

Timestamp

Apenas saída. Horário em que o pedido foi enviado. É preenchido automaticamente com o horário atual quando um pedido é enviado.

billing_id

string

Apenas saída. O ID do Cloud Billing que será cobrado por este pedido.

existing_hardware[]

HardwareLocation

Opcional. Hardware atual a ser removido como parte deste pedido. Observação: todo hardware removido será reciclado, a menos que seja acordado de outra forma.

deployment_type

DeploymentType

Apenas saída. O tipo de implantação deste pedido.

actual_installation_date

Date

Apenas saída. Data de instalação real do pedido.

estimated_installation_date

Date

Apenas saída. Data de instalação estimada para este pedido.

estimated_delivery_date

Date

Apenas saída. Data de entrega estimada para este pedido.

migration

bool

Opcional. Se este pedido é uma migração da infraestrutura atual do cliente.

accepted_time

Timestamp

Apenas saída. O horário em que o pedido foi movido para o estado ACCEPTED.

requested_date_change

Date

Apenas saída. A data em que o cliente ou o Google quer definir a data de instalação programada.

vendor_notes

string

Apenas saída. Observações sobre este pedido, fornecidas pelo fornecedor.

vendor_contact

OrganizationContact

Apenas saída. Informações de contato do SI atribuído a este pedido.

ai_capable

bool

Apenas saída. Indica se este pedido é para hardware compatível com o Gemini no software do GDC. Preenchido automaticamente após o envio do pedido.

requested_delivery_date

Date

Opcional. Os clientes podem usar esse campo para especificar a data em que querem que o hardware seja entregue.

DeploymentType

Tipos válidos de uma implantação.

Tipos enumerados
DEPLOYMENT_TYPE_UNSPECIFIED O tipo de implantação não foi especificado.
FULL_PRODUCTION Implantação de produção com SLOs.
PROOF_OF_CONCEPT Implantação com suporte de melhor esforço e sem SLOs.
INTERNAL Implantação interna com suporte de melhor esforço e sem SLOs.
CUSTOMER_LAB Implantação de laboratório do cliente que oferecemos suporte como se fosse de produção.
INTERNAL_CANARY Canário interno.

Estado

Estados válidos de um pedido.

Tipos enumerados
STATE_UNSPECIFIED O estado do pedido não foi especificado.
DRAFT O pedido está sendo elaborado pelo cliente e ainda não foi enviado.
SUBMITTED O pedido foi enviado ao Google.
INFO_COMPLETE Todas as informações necessárias do cliente para o atendimento do pedido estão completas.
ACCEPTED O pedido foi aceito pelo Google.
ADDITIONAL_INFO_NEEDED O pedido precisa de mais informações do cliente.
BUILDING O Google iniciou a fabricação do hardware para o pedido.
SHIPPING O hardware foi construído e está sendo enviado.
INSTALLING O hardware está sendo instalado.
FAILED Ocorreu um erro ao processar o pedido, e o cliente precisa intervir.
PARTIALLY_COMPLETED O pedido foi parcialmente concluído, ou seja, alguns hardwares foram entregues e instalados.
COMPLETED O pedido foi concluído.
CANCELLED O pedido foi cancelado.

Tipo

Tipos válidos de um pedido.

Tipos enumerados
TYPE_UNSPECIFIED O tipo de pedido não foi especificado.
PAID Pago pelo cliente.
POC Prova de conceito para o cliente.
UNPAID Não faturados.

OrganizationContact

Dados de contato da organização do cliente.

Campos
address

PostalAddress

Obrigatório. O endereço da organização.

email

string

Opcional. O e-mail da organização.

phone

string

Opcional. O número de telefone da organização.

contacts[]

Contact

Obrigatório. Os pontos de contato individuais na organização nesse local. Dependente da ordem: o primeiro contato na lista é o principal, o segundo é o secundário etc.

PowerSupply

As opções de fonte de alimentação.

Tipos enumerados
POWER_SUPPLY_UNSPECIFIED A fonte de alimentação não foi especificada.
POWER_SUPPLY_AC Fonte de alimentação CA.
POWER_SUPPLY_DC Fonte de alimentação CC.

RackSpace

Representa o espaço contíguo em um rack.

Campos
start_rack_unit

int32

Obrigatório. Primeira unidade do rack (inclusive).

end_rack_unit

int32

Obrigatório. Última unidade do espaço do rack (inclusive).

RecordActionOnCommentRequest

Uma solicitação para registrar uma ação em um comentário.

Campos
name

string

Obrigatório. O nome do comentário. Formato: projects/{project}/locations/{location}/orders/{order}/comments/{comment}

action_type

ActionType

Obrigatório. O tipo da ação registrada.

ActionType

Tipos de ação válidos de Comment.

Tipos enumerados
ACTION_TYPE_UNSPECIFIED A ação não foi especificada.
READ Marcar comentário como lido.
UNREAD Marcar comentário como não lido.

RequestOrderDateChangeRequest

Uma solicitação para mudar a data de um pedido.

Campos
name

string

Obrigatório. O nome do pedido a ser atualizado. Formato: projects/{project}/locations/{location}/orders/{order}

requested_date

Date

Obrigatório. A data em que o cliente ou o Google quer definir a data de instalação programada.

reason

Reason

Opcional. O motivo da mudança de data solicitada.

reason_details

string

Opcional. Se o motivo da mudança de data solicitada for "OTHER", esse campo precisará ser preenchido.

Motivo

Motivos válidos para a mudança de data solicitada.

Tipos enumerados
REASON_UNSPECIFIED O motivo da mudança de data não foi especificado.
REASON_SITE_NOT_READY O local não está pronto para a instalação.
REASON_FACILITY_ACCESS_ISSUE Há um problema de acesso à instalação.
REASON_CONSTRUCTION_OR_RENOVATION_DELAY Há um atraso na construção ou reforma.
REASON_POINT_OF_CONTACT_UNAVAILABLE O ponto de contato está indisponível.
REASON_SCHEDULE_CONFLICT Há um conflito de programação.
REASON_SPECIFIED_INCORRECT_DATE A data solicitada especificada anteriormente estava incorreta.
REASON_OTHER Outro motivo.

ResourceOperation

Representa uma operação em andamento para um recurso

Campos
uid

string

Apenas saída. ID da operação.

state

State

Apenas saída. Estado da operação.

type

Type

Apenas saída. Tipo de operação.

state_history[]

StateHistoryEntry

Apenas saída. Histórico de estado da operação.

requires_re_turnup

bool

Apenas saída. Uma flag para indicar se é necessário fazer uma nova ativação.

Estado

Tipo enumerado para estados de operação.

Tipos enumerados
STATE_UNSPECIFIED Estado de operação não especificado.
AWAITING_CUSTOMER_INPUT A operação está aguardando a entrada do cliente.
PROGRESSING A operação está em andamento.
COMPLETED A operação foi concluída.

StateHistoryEntry

Entrada para o histórico de estado da operação.

Campos
state

State

Apenas saída. Estado da operação.

update_time

Timestamp

Apenas saída. Carimbo de data/hora de quando o estado da operação foi atualizado.

reason

string

Apenas saída. Motivo da mudança de estado.

responsible_entity

Entity

Apenas saída. Entidade que mudou o estado.

Tipo

O tipo de operação Novos valores podem ser adicionados a esse tipo enumerado no futuro.

Tipos enumerados
TYPE_UNSPECIFIED Tipo de operação não especificado.
REPAIR Operação de reparo.
SUSPEND Suspender operação.
RESUME Retomar operação.

ShippingInfo

ShippingInfo descreve as informações de logística de uma remessa.

Campos
carrier

Carrier

Apenas saída. A transportadora do envio.

tracking_id

string

Apenas saída. O ID de rastreamento do envio.

SignalHardwareStateRequest

Uma solicitação para sinalizar o estado de um hardware.

Campos
name

string

Obrigatório. O nome do hardware. Formato: projects/{project}/locations/{location}/hardware/{hardware}

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

state_signal

StateSignal

Opcional. Especifica o indicador de estado a ser enviado para esse hardware.

operation_type

Type

Opcional. Especifica o tipo de operação para sinalizar o estado. Se o tipo não for especificado, o sinal será considerado para o provisionamento inicial.

re_turnup_required

bool

Opcional. Indica se é necessário fazer uma nova ativação ao finalizar um processo de reparo.

StateSignal

Indicadores de estado válidos para um hardware.

Tipos enumerados
STATE_SIGNAL_UNSPECIFIED O sinal de estado do hardware não foi especificado.
READY_FOR_PROVISIONING O hardware está pronto para provisionamento.

SignalZoneStateRequest

Uma solicitação para sinalizar o estado de uma zona.

Campos
name

string

Obrigatório. O nome da zona. Formato: projects/{project}/locations/{location}/zones/{zone}

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

state_signal

StateSignal

Opcional. O sinal de estado a ser enviado para esta zona. É necessário definir state_signal ou provisioning_state_signal, mas não ambos.

provisioning_state_signal

ProvisioningStateSignal

Opcional. O indicador de estado de provisionamento a ser enviado para esta zona. É necessário definir state_signal ou provisioning_state_signal, mas não ambos.

step

string

Opcional. A etapa que está sendo executada. Fornece um status mais detalhado quando o state_signal é FACTORY_TURNUP_CHECKS_STARTED ou FACTORY_TURNUP_CHECKS_FAILED.

details

string

Opcional. Detalhes adicionais, como uma mensagem de erro quando state_signal é FACTORY_TURNUP_CHECKS_FAILED. Ele também pode incluir a saída da validação do site.

ProvisioningStateSignal

Sinais de estado de provisionamento válidos para uma zona.

Tipos enumerados
PROVISIONING_STATE_SIGNAL_UNSPECIFIED O indicador de estado de provisionamento não foi especificado.
PROVISIONING_IN_PROGRESS O provisionamento está em andamento.
PROVISIONING_COMPLETE O provisionamento foi concluído.

StateSignal

Sinais de estado válidos para uma zona.

Tipos enumerados
STATE_SIGNAL_UNSPECIFIED O sinal de estado da zona não foi especificado.
FACTORY_TURNUP_CHECKS_STARTED As verificações de ativação de fábrica foram iniciadas.
FACTORY_TURNUP_CHECKS_PASSED A zona está pronta para a ativação do site.
READY_FOR_SITE_TURNUP

A zona está pronta para a ativação do site. Descontinuado, mas não excluído.

FACTORY_TURNUP_CHECKS_FAILED A zona falhou nas verificações de ativação de fábrica.
VERIFY_CLUSTER_INTENT_PRESENCE Verifique se há uma intent de cluster válida.
SITE_VALIDATION_PASSED A validação do site foi aprovada em todas as verificações.
SITE_VALIDATION_FAILED Falha na validação do site.

Site

Um local físico em que o hardware será instalado.

Campos
name

string

Identificador. Nome do site. Formato: projects/{project}/locations/{location}/sites/{site}

display_name

string

Opcional. Nome de exibição do site.

description

string

Opcional. Descrição do site.

create_time

Timestamp

Apenas saída. Hora em que o site foi criado.

update_time

Timestamp

Apenas saída. Hora em que o site foi atualizado pela última vez.

labels

map<string, string>

Opcional. Rótulos associados a este site como pares de chave-valor. Para mais informações sobre rótulos, consulte Criar e gerenciar rótulos.

organization_contact

OrganizationContact

Obrigatório. Dados de contato do site.

google_maps_pin_uri

string

Opcional. Um URL para o endereço do site no Google Maps. Um valor de exemplo é https://goo.gl/maps/xxxxxxxxx.

access_times[]

TimePeriod

Opcional. Os períodos em que o site está acessível. Se esse campo estiver vazio, o site poderá ser acessado a qualquer momento.

Esse campo é usado pelo Google para programar a instalação inicial e qualquer manutenção de hardware posterior. Você pode atualizar essa informação a qualquer momento. Por exemplo, se a instalação inicial for solicitada durante o período de pausa, mas a manutenção precisar ser realizada durante o horário de funcionamento normal, atualize os horários de acesso após a conclusão da instalação inicial.

notes

string

Opcional. Mais observações sobre o site. Inclua informações sobre: - restrições de segurança ou acesso - regulamentações que afetam os técnicos que visitam o local - processos especiais ou aprovações necessárias para mover o equipamento - se um representante estará disponível durante as visitas ao local

customer_site_id

string

Opcional. Identificador definido pelo cliente para este site. Isso pode ser usado para identificar o site nos sistemas do cliente.

installation_requirements_met

bool

Opcional. Indica se o site do cliente atende a todos os requisitos de instalação.

SKU

Uma unidade de manutenção de estoque (SKU) do hardware do GDC.

Campos
name

string

Identificador. Nome da SKU. Formato: projects/{project}/locations/{location}/skus/{sku}

display_name

string

Apenas saída. Nome de exibição desta SKU.

create_time

Timestamp

Apenas saída. Hora em que esta SKU foi criada.

update_time

Timestamp

Apenas saída. Hora em que a SKU foi atualizada pela última vez.

config

SkuConfig

Apenas saída. Configuração para esta SKU.

instances[]

SkuInstance

Apenas saída. Instâncias disponíveis desta SKU. Esse campo deve ser usado para verificar a disponibilidade de uma SKU.

description

string

Apenas saída. Descrição da SKU.

revision_id

string

Apenas saída. O ID da revisão da SKU. Uma nova revisão é criada sempre que config é atualizado. O formato é uma string hexadecimal de 8 caracteres.

is_active

bool

Apenas saída. Sinalização para indicar se esta revisão está ativa ou não. Somente uma revisão ativa pode ser usada em um novo pedido.

type

Type

Apenas saída. Tipo da SKU.

vcpu_count

int32

Apenas saída. A contagem de vCPUs associada a essa SKU.

hardware_count_ranges[]

Range

Apenas saída. Os intervalos inclusivos de contagens de hardware permitidos em uma zona que usa essa SKU.

ai_capable

bool

Apenas saída. Se esta SKU é para hardware que executa o Gemini no software do GDC.

customer_sourced

bool

Apenas saída. Se esta SKU é para hardware fornecido pelo cliente.

Intervalo

Intervalo inclusivo.

Campos
min

int32

O valor mínimo do intervalo.

max

int32

O valor máximo do intervalo.

Tipo

Tipos válidos de uma SKU.

Tipos enumerados
TYPE_UNSPECIFIED O tipo da SKU não foi especificado. Esse não é um valor permitido.
RACK SKU do rack.
SERVER SKU do servidor.

SkuConfig

Configuração de uma SKU.

Campos
cpu

string

Informações sobre a configuração da CPU.

gpu

string

Informações sobre a configuração da GPU.

ram

string

Informações sobre a configuração de RAM.

storage

string

Informações sobre a configuração do armazenamento.

SkuInstance

Uma instância específica da SKU.

Campos
region_code

string

O código de região Unicode CLDR em que essa instância está disponível.

power_supply

PowerSupply

Tipo de fonte de alimentação para esta instância.

billing_sku

string

Referência à SKU correspondente na API Cloud Billing. As informações de preço estimado podem ser recuperadas usando essa API. Formato: services/{service}/skus/{sku}

billing_sku_per_vcpu

string

Referência à SKU correspondente por vCPU na API Cloud Billing. As informações de preço estimado podem ser recuperadas usando essa API. Formato: services/{service}/skus/{sku}

subscription_duration_months

int32

Duração da assinatura do hardware em meses.

SubmitOrderRequest

Uma solicitação para enviar um pedido.

Campos
name

string

Obrigatório. O nome do pedido. Formato: projects/{project}/locations/{location}/orders/{order}

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

type

Type

Opcional. Tipo desta solicitação. Se não for definido, o tipo de solicitação será considerado INFO_PENDING.

Tipo

Tipos válidos de solicitação de envio de pedido.

Tipos enumerados
TYPE_UNSPECIFIED O tipo de solicitação não foi especificado. Isso não deve ser usado.
INFO_PENDING Use esse tipo de solicitação para enviar seu pedido e iniciar uma conversa com o Google. Depois do envio, não será possível modificar o número ou a SKU do hardware pedido. Esse pedido só estará pronto para processamento quando você fornecer mais informações, como configuração de rede da zona, informações físicas e de instalação do hardware etc. Se você estiver enviando um pedido para um tipo de SKU de RACK, use esse tipo de solicitação, já que outras informações serão necessárias fora da API.
INFO_COMPLETE Use esse tipo de solicitação quando estiver tudo pronto para enviar o pedido para processamento. Além das informações necessárias para INFO_PENDING, o pedido precisa conter todas as informações necessárias, como configuração de rede da zona, informações físicas e de instalação do hardware etc. Não será mais permitido fazer mudanças nas informações do pedido.

Sub-rede

Representa uma sub-rede.

Campos
address_range

string

Obrigatório. Intervalo de endereços desta sub-rede na notação CIDR.

default_gateway_ip_address

string

Obrigatório. Gateway padrão para esta sub-rede.

SubscriptionConfig

Uma mensagem para armazenar uma configuração de assinatura.

Campos
subscription_id

string

Apenas saída. O identificador exclusivo da assinatura.

billing_id

string

Apenas saída. O ID do Cloud Billing em que a assinatura foi criada.

state

SubscriptionState

Apenas saída. O estado atual da assinatura.

start_time

Timestamp

Apenas saída. O horário de início da assinatura.

SubscriptionState

Tipo enumerado para representar o estado da assinatura.

Tipos enumerados
SUBSCRIPTION_STATE_UNSPECIFIED Estado não especificado.
ACTIVE O estado ativo significa que a assinatura foi criada com sucesso e o faturamento está ocorrendo.
INACTIVE "Inativa" significa que a assinatura foi criada, mas o faturamento ainda não começou.
ERROR A assinatura está em um estado de erro.
FAILED_TO_RETRIEVE Falha ao recuperar o estado da assinatura. Esse problema pode ser temporário. O usuário precisa tentar fazer a solicitação novamente.
COMPLETED A assinatura foi concluída porque chegou à data de término.

TimePeriod

Representa um período em uma semana.

Campos
start_time

TimeOfDay

Obrigatório. O início do período.

end_time

TimeOfDay

Obrigatório. O fim do período.

days[]

DayOfWeek

Obrigatório. Os dias da semana em que o período está ativo.

UpdateHardwareGroupRequest

Uma solicitação para atualizar um grupo de hardware.

Campos
update_mask

FieldMask

Obrigatório. Uma máscara para especificar os campos no HardwareGroup que serão substituídos por essa atualização. Os campos especificados em update_mask são relativos ao grupo de hardware, não à solicitação completa. Um campo será substituído se estiver na máscara. Se você não fornecer uma máscara, todos os campos serão substituídos.

hardware_group

HardwareGroup

Obrigatório. O grupo de hardware a ser atualizado.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

UpdateHardwareRequest

Uma solicitação para atualizar o hardware.

Campos
update_mask

FieldMask

Obrigatório. Uma máscara para especificar os campos no hardware que serão substituídos por essa atualização. Os campos especificados em update_mask são relativos ao hardware, não à solicitação completa. Um campo será substituído se estiver na máscara. Se você não fornecer uma máscara, todos os campos serão substituídos.

hardware

Hardware

Obrigatório. O hardware a ser atualizado.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

UpdateOrderRequest

Uma solicitação para atualizar um pedido.

Campos
update_mask

FieldMask

Obrigatório. Uma máscara para especificar os campos no pedido que serão substituídos por essa atualização. Os campos especificados em update_mask são relativos ao pedido, não à solicitação completa. Um campo será substituído se estiver na máscara. Se você não fornecer uma máscara, todos os campos serão substituídos.

order

Order

Obrigatório. O pedido a ser atualizado.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

UpdateSiteRequest

Uma solicitação para atualizar um site.

Campos
update_mask

FieldMask

Obrigatório. Uma máscara para especificar os campos no site que serão substituídos por essa atualização. Os campos especificados em update_mask são relativos ao site, não à solicitação completa. Um campo será substituído se estiver na máscara. Se você não fornecer uma máscara, todos os campos serão substituídos.

site

Site

Obrigatório. O site a ser atualizado.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

UpdateZoneOperationRequest

Mensagem de solicitação para atualizar uma ZoneOperation.

Campos
update_mask

FieldMask

Opcional. A máscara de campo é usada para especificar os campos a serem substituídos no recurso ZoneOperation pela atualização. Os campos especificados em update_mask são relativos ao recurso, não à solicitação completa. Um campo será substituído se estiver na máscara. Se o usuário não fornecer uma máscara, todos os campos serão substituídos.

zone_operation

ZoneOperation

Obrigatório. O recurso que está sendo atualizado.

request_id

string

Opcional. Um ID de solicitação opcional para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se precisar repetir a solicitação, o servidor saberá que é preciso ignorar a solicitação se ela já tiver sido concluída. O servidor vai garantir isso por pelo menos 60 minutos após a primeira solicitação.

UpdateZoneRequest

Uma solicitação para atualizar uma zona.

Campos
update_mask

FieldMask

Obrigatório. Uma máscara para especificar os campos na zona que serão substituídos por essa atualização. Os campos especificados em update_mask são relativos à zona, não à solicitação completa. Um campo será substituído se estiver na máscara. Se você não fornecer uma máscara, todos os campos serão substituídos.

zone

Zone

Obrigatório. A zona a ser atualizada.

request_id

string

Opcional. Um identificador exclusivo opcional para essa solicitação. Consulte AIP-155.

ValidateHardwareRequest

Uma solicitação para validar o hardware.

Campos
parent

string

Obrigatório. O projeto e o local em que o hardware será validado. Formato: projects/{project}/locations/{location}

data

Struct

Obrigatório. Os dados a serem validados. Ele contém o tipo de validação (BOM, BMC, NW) e as informações da plataforma com os detalhes necessários para a validação. Sample JSON: { "validation_type": "BOM", "machine_spec": "DellXE9680Spec", "platform_info": { "bom_validation_info": { "bios_version": { "cmd": "echo 2.6.3", "failed": false, "rc": 0.0, "stderr": "", "stdout": "2.6.3" } } } }

ValidateHardwareResponse

Mensagem de resposta para o método ValidateHardware.

Campos
validation_results[]

ValidationResult

Os resultados da validação.

ValidationResult

O resultado de uma validação.

Campos
type

string

O tipo da validação.

status

string

O status da validação.

message

string

A mensagem do resultado da validação.

resolutions[]

string

Opcional. Resoluções recomendadas para a falha de validação.

Zona

Uma zona que contém um conjunto de hardware.

Campos
name

string

Identificador. Nome desta zona. Formato: projects/{project}/locations/{location}/zones/{zone}

create_time

Timestamp

Apenas saída. Horário em que a zona foi criada.

update_time

Timestamp

Apenas saída. Hora em que esta zona foi atualizada pela última vez.

labels

map<string, string>

Opcional. Rótulos associados a essa zona como pares de chave-valor. Para mais informações sobre rótulos, consulte Criar e gerenciar rótulos.

display_name

string

Opcional. Nome de exibição legível por humanos desta zona.

state

State

Apenas saída. Estado atual desta zona.

contacts[]

Contact

Obrigatório. Os pontos de contato da zona (nome, e-mail, telefone). Dependente da ordem: o primeiro contato na lista é o principal, o segundo é o secundário etc.

ciq_uri

string

Apenas saída. Link para a planilha do Questionário de admissão do cliente (CIQ, na sigla em inglês) para essa zona.

network_config

ZoneNetworkConfig

Opcional. Configuração de rede para esta zona.

globally_unique_id

string

Apenas saída. Identificador exclusivo globalmente gerado para esta zona de borda.

subscription_configs[]

SubscriptionConfig

Apenas saída. Configurações de assinatura para esta zona.

provisioning_state

ProvisioningState

Apenas saída. Estado de provisionamento para configurações como endereços MAC.

skip_cluster_provisioning

bool

Opcional. Se a etapa de provisionamento do cluster deve ser ignorada durante a ativação de fábrica. Se for verdadeiro, indica que o cluster do Kubernetes será criado depois que o hardware da zona for instalado no site do cliente.

cluster_intent_required

bool

Apenas saída. Indica se o cliente precisa fornecer uma intent de cluster válida antes de aceitar o pedido. Se for verdadeiro, o pedido não poderá ser aceito até que a intenção do cluster esteja presente. Isso é usado para aplicar a validação antecipada e evitar atrasos causados por configurações ausentes.

cluster_intent_verified

bool

Apenas saída. Indica se a intent do cluster fornecida foi verificada. Essa flag garante que a intenção do cluster exista antes que o pedido possa ser aceito.

ai_capable

bool

Opcional. Indica se essa zona é para o cluster do Gemini no GDC Software.

intel_pccs_key

string

Opcional. Chave do Serviço de Configuração e Atestado de Plataforma (PCCS, na sigla em inglês) da Intel para provisionar e atestar o hardware do acelerador de IA. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

current_resource_operation

ResourceOperation

Apenas saída. A operação de recurso atual para a zona.

resource_operations[]

ResourceOperation

Opcional. Lista de todas as operações de recursos que foram realizadas na zona.

errors[]

Status

Apenas saída. Os erros encontrados durante a ativação da zona. Os metadados de ErrorInfo vão incluir o carimbo de data/hora e se o erro pode ser repetido.

site

string

Opcional. Especifica o nome do local em que o hardware desta zona reside. Formato: projects/{project}/locations/{location}/sites/{site} Obrigatório para zonas do Gemini no software do GDC.

ProvisioningState

Estados de provisionamento válidos para configurações como endereços MAC.

Tipos enumerados
PROVISIONING_STATE_UNSPECIFIED O estado de provisionamento não foi especificado.
PROVISIONING_REQUIRED O provisionamento é obrigatório. Definido pelo Google.
PROVISIONING_IN_PROGRESS O provisionamento está em andamento. Definido pelo cliente.
PROVISIONING_COMPLETE O provisionamento foi concluído. Definido pelo cliente.

Estado

Estados válidos para uma zona.

Tipos enumerados
STATE_UNSPECIFIED O estado da zona não foi especificado.
ADDITIONAL_INFO_NEEDED O cliente precisa fornecer mais informações para que o processo continue.
INFO_COMPLETE A Zona tem todas as informações necessárias para iniciar a preparação.
PREPARING O Google está preparando a zona.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS A ativação de fábrica foi concluída.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED A zona está executando verificações de ativação de fábrica.
READY_FOR_PROVISIONING A zona está pronta para provisionamento.
READY_FOR_SITE_TURNUP A zona está pronta para a ativação do site.
PROVISIONING_STARTED O provisionamento da zona foi iniciado.
PROVISIONING_FAILED Falha no provisionamento da zona.
OFFLINE A Zona está off-line.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED A zona falhou nas verificações de ativação de fábrica.
ACTIVE A zona está disponível para uso.
CANCELLED A zona foi cancelada.
AWAITING_HARDWARE A zona está aguardando a associação de hardware.

ZoneNetworkConfig

Configuração de rede para uma zona.

Campos
machine_mgmt_ipv4_range

string

Obrigatório. Um bloco de endereços IPv4 para gerenciamento de máquinas. Precisa ser um bloco CIDR público ou RFC1918 privado grande o suficiente para alocar pelo menos um endereço por máquina na zona. Precisa estar em management_ipv4_subnet e ser separado de outros intervalos de endereços.

kubernetes_node_ipv4_range

string

Obrigatório. Um bloco de endereços IPv4 para nós do Kubernetes. Precisa ser um bloco CIDR público ou RFC1918 privado grande o suficiente para alocar pelo menos um endereço por máquina na zona. Precisa estar em kubernetes_ipv4_subnet e ser separado de outros intervalos de endereços.

kubernetes_control_plane_ipv4_range

string

Obrigatório. Um bloco de endereços IPv4 para o plano de controle do Kubernetes. Precisa ser um bloco CIDR público ou RFC1918 privado grande o suficiente para alocar pelo menos um endereço por cluster na zona. Precisa estar em kubernetes_ipv4_subnet e ser separado de outros intervalos de endereços.

management_ipv4_subnet

Subnet

Obrigatório. Uma sub-rede IPv4 para a rede de gerenciamento.

kubernetes_ipv4_subnet

Subnet

Opcional. Uma sub-rede IPv4 para a rede do Kubernetes. Se não for especificada, a sub-rede do Kubernetes será igual à de gerenciamento.

dns_ipv4_addresses[]

string

Opcional. Servidores de nomes DNS. A infraestrutura do GDC resolve as consultas de DNS usando esses IPs. Quando o valor não for especificado, o DNS do Google será usado.

kubernetes_primary_vlan_id

int32

Opcional. ID da VLAN do Kubernetes. Por padrão, o nó do Kubernetes, incluindo a rede principal do Kubernetes, está na mesma VLAN que a rede de gerenciamento de máquinas. Para fins de segmentação de rede, é possível separá-los (opcional).

ai_capable_ipv4_subnet

Subnet

Opcional. Sub-rede IPv4 para uma zona que disponibiliza o Gemini no cluster do software do GDC. A última sub-rede /29 do intervalo fornecido é reservada para DHCP.

bgp_config

BGPConfig

Opcional. Configuração específica do protocolo de gateway de borda (BGP) para esta zona. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

top_level_domain

string

Opcional. Domínio de nível superior personalizado para esta zona. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

tor_switch_type

string

Opcional. Informações adicionais sobre o tipo de switch ToR do cliente. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

boundary_proxy_public_ipv4_range

string

Opcional. Intervalo IPv4 público do proxy de limite na notação CIDR. No momento, /32 é esperado. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

boundary_proxy_private_edge_core_ipv4_range

string

Opcional. Intervalo de IPv4 do proxy de limite de borda privada para o núcleo na notação CIDR. No momento, /32 é esperado. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

boundary_proxy_private_core_edge_ipv4_range

string

Opcional. Intervalo IPv4 do núcleo privado para a borda do proxy de limite na notação CIDR. No momento, /32 é esperado. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

bastion_host_public_ipv4_range

string

Opcional. Intervalo IPv4 público do Bastion Host na notação CIDR. No momento, /32 é esperado. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

bastion_host_private_ipv4_range

string

Opcional. Intervalo de IPv4 privado do Bastion Host na notação CIDR. No momento, /32 é esperado. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

tls_public_root_certificate_pem

string

Opcional. Certificado raiz público de TLS no formato PEM. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

ZoneOperation

Representa uma operação em uma zona.

Campos
name

string

Identificador. Nome da operação. Formato: "projects/{project}/locations/{location}/zones/{zone}/ops/{zone_operation}"

create_time

Timestamp

Apenas saída. Hora em que a operação foi criada.

update_time

Timestamp

Apenas saída. Hora em que esta operação foi atualizada pela última vez.

labels

map<string, string>

Opcional. Rótulos associados a essa operação como pares de chave-valor.

type

Type

Obrigatório. Imutável. O tipo desta operação.

impacted_hardware[]

string

Opcional. O hardware afetado por essa operação de zona.

state

State

Apenas saída. O estado da operação.

current_step

ZoneOperationStep

Apenas saída. A etapa atual da operação.

step_history[]

ZoneOperationStep

Apenas saída. Histórico de etapas da operação.

etag

string

Opcional. Adicionando uma etag com base em go/ccfe-etag.

Estado

Estados válidos para uma operação de zona.

Tipos enumerados
STATE_UNSPECIFIED Estado não definido.
RUNNING A operação está em andamento.
SUCCEEDED A operação foi concluída.
FAILED Falha na operação.
CANCELLED A operação foi cancelada.

Tipo

O tipo de operação

Tipos enumerados
TYPE_UNSPECIFIED Tipo não definido.
EXPANSION Operação de expansão de zona.

ZoneOperationStep

Representa uma etapa do fluxo de trabalho.

Campos
state

StepState

Apenas saída. O estado da etapa do fluxo de trabalho.

start_time

Timestamp

Apenas saída. O horário em que a etapa do fluxo de trabalho começou.

end_time

Timestamp

Apenas saída. A hora em que a etapa do fluxo de trabalho terminou.

error

Status

Apenas saída. A mensagem de erro da etapa do fluxo de trabalho, se houver falha.

Campo de união step_type. O tipo de etapa. step_type pode ser apenas de um dos tipos a seguir:
expansion_step

ExpansionStep

Etapa para o tipo de operação EXPANSION.

ExpansionStep

Etapas válidas de um fluxo de trabalho de EXPANSÃO.

Tipos enumerados
EXPANSION_STEP_UNSPECIFIED Etapa não especificada.
PREPARING_ZONE Atualiza a intent de zona para ativação lógica.
HW_ID_UPDATE Atualiza a lista de hardware com identificadores.

StepState

Estados válidos de uma etapa do fluxo de trabalho.

Tipos enumerados
STEP_STATE_UNSPECIFIED Estado da etapa do fluxo de trabalho não especificado.
PENDING A etapa está aguardando para começar.
RUNNING A etapa está em andamento.
SUCCEEDED A etapa foi concluída.
FAILED A etapa falhou.
SKIPPED A etapa foi ignorada.