Todos os produtos
Search

Este produto

    Tair (Redis® OSS-Compatible):CreateTairKVCacheVNode

    Central de documentação

    Tair (Redis® OSS-Compatible):CreateTairKVCacheVNode

    Última atualização: Oct 23, 2026

    Cria uma instância de nó virtual VNode do Tair.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    kvstore:CreateTairKVCacheVNode

    create

    *All resources.

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    RegionId

    string

    Sim

    O ID da região. Especifica a região onde você deseja criar a instância.

    cn-beijing
    ZoneId

    string

    Sim

    O ID da zona. Especifica a zona onde você deseja criar a instância.

    cn-beijing-f
    InstanceName

    string

    Não

    O nome da nova instância. O nome deve ter de 2 a 80 caracteres e começar com uma letra ou um caractere chinês. Não pode conter espaços nem os seguintes caracteres especiais: @/:="<>{[]}.

    vnodetest
    InstanceClass

    string

    Sim

    O tipo de instância.

    kvcache.cu.g4b.2

    ComputeUnitNum

    integer

    Sim

    O número de unidades de computação. Atualmente, apenas uma unidade de computação é suportada.

    Valores válidos:

    • 1 :

      1

    1
    VkName

    string

    Sim

    O ID da instância do cluster virtual VCluster no qual o VNode reside.

    tk-2ze4bba3c8fe****

    VSwitchId

    string

    Sim

    O ID do vSwitch da instância. O vSwitch deve pertencer à VPC do cluster virtual VCluster especificado. Você pode chamar a operação DescribeVpcs da API VPC para consultar o ID do vSwitch.

    Nota

    A zona do vSwitch deve ser a mesma da instância.

    vsw-bp1e7clcw529l773d****
    ChargeType

    string

    Não

    O método de cobrança. Valores válidos:

    • PrePaid: assinatura. Se você definir este parâmetro como PrePaid, também deverá especificar o parâmetro Period.

    Valores válidos:

    • PrePaid :

      Assinatura.

    PrePaid
    Period

    integer

    Não

    O período de assinatura. Unidade: meses. Valores válidos: 1 a 9, 12, 24 e 36.

    Nota

    Este parâmetro é obrigatório quando ChargeType é definido como PrePaid.

    1
    BusinessInfo

    string

    Não

    As informações estendidas, como o ID da campanha e as informações comerciais.

    000000000

    CouponNo

    string

    Não

    O código do cupom.

    youhuiquan_promotion_option_id_for_blank
    AutoUseCoupon

    boolean

    Não

    Especifica se deve ser usado um voucher. Valores válidos:

    • true: usa um voucher.

    • false (padrão): não usa um voucher.

    false
    AutoRenew

    boolean

    Não

    Especifica se a renovação automática deve ser ativada. Valores válidos:

    • true: ativa a renovação automática.

    • false (padrão): desativa a renovação automática.

    false
    AutoRenewPeriod

    string

    Não

    O período de renovação automática. Unidade: meses. Valores válidos: 1, 2, 3, 6 e 12.

    Nota

    Este parâmetro é obrigatório quando AutoRenew é definido como true.

    1
    ResourceGroupId

    string

    Não

    O ID do grupo de recursos de destino.

    Nota

    rg-acfmyiu4ekp****
    AutoPay

    boolean

    Não

    Especifica se o pagamento automático deve ser ativado. Defina o valor como true.

    Valores válidos:

    • true :

      Pagamento automático.

    true
    ClientToken

    string

    Não

    O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token diferencia maiúsculas de minúsculas e pode conter até 64 caracteres ASCII.

    ETnLKlblzczshOTUbOCz****
    Tag

    array<object>

    Não

    As informações de tag da instância.

    object

    Não

    As informações de tag da instância.

    Key

    string

    Não

    A chave da tag. Ela forma um par chave-valor com o valor da tag.

    Nota

    Você pode especificar até 5 pares chave-valor de tag por vez.

    value1_test
    Value

    string

    Não

    O valor da tag.

    Nota

    N especifica o enésimo valor da tag. Por exemplo, Tag.1.Value especifica o valor da primeira tag e Tag.2.Value especifica o valor da segunda tag.

    key1_test
    DryRun

    boolean

    Não

    Especifica se deve ser realizado um dry run na operação de criação da instância. Valores válidos:

    • true: realiza um dry run sem criar a instância. O sistema verifica os parâmetros da solicitação, o formato da solicitação, os limites do serviço e os recursos disponíveis. Se a solicitação falhar no dry run, o sistema retornará um erro. Se a solicitação passar no dry run, o sistema retornará o código de erro DryRunOperation.

    • false (padrão): envia uma solicitação normal. Se a solicitação passar na verificação, a instância será criada.

    false
    VNodeType

    string

    Não

    O tipo de nó virtual. Valores válidos: fixed e elastic.

    fixed
    ElasticTimeRange

    string

    Não

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    RequestId

    string

    O ID da solicitação.

    2BE6E619-A657-42E3-AD2D-18F8428A****
    InstanceId

    string

    O ID da instância do nó virtual.

    tv-2zeb1ce76fee****
    OrderId

    integer

    O ID do pedido.

    20905403119****
    RegionId

    string

    O ID da região.

    cn-beijing
    ZoneId

    string

    O ID da zona.

    cn-beijing-f
    VkName

    string

    O ID da instância do cluster virtual.

    tk-2ze4bba3c8fe****

    VClusterId

    string

    O ID do cluster virtual.

    vc-16965a9267*****-*****
    NodeId

    string

    O ID do nó virtual.

    vn-03a49876edb****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "2BE6E619-A657-42E3-AD2D-18F8428A****",
  "InstanceId": "tv-2zeb1ce76fee****",
  "OrderId": 0,
  "RegionId": "cn-beijing",
  "ZoneId": "cn-beijing-f",
  "VkName": "tk-2ze4bba3c8fe****\n",
  "VClusterId": "vc-16965a9267*****-*****",
  "NodeId": "vn-03a49876edb****"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 MissingParameter Period is mandatory for this action.
    400 InvalidToken.Malformed The Specified parameter Token is not valid.
    400 InvalidInstanceName.Malformed The Specified parameter InstanceName is not valid.
    400 InvalidPassword.Malformed The Specified parameter Password is not valid.
    400 InsufficientBalance Your account does not have enough balance.
    400 QuotaExceed.AfterpayInstance Living afterpay instances quota exceeded.
    400 InvalidCapacity.NotFound The Capacity provided does not exist in our records.
    400 ResourceNotAvailable Resource you requested is not available for finance user.
    400 PaymentMethodNotFound No payment method has been registered on the account.
    400 IdempotentParameterMismatch Request uses a client token in a previous request but is not identical to that request. A verificação de idempotência falhou.
    400 QuotaNotEnough Quota not enough in this zone.
    400 QuotaExceed Living afterpay instances quota exceed.
    400 VpcServiceError Invoke vpc service failed.
    400 IzNotSupportVpcError Specify iz not support vpc.
    400 InvalidvSwitchId The vpc does not cover the vswitch.
    400 InvalidIzNo.NotSupported The Specified vpc zone not supported.
    400 InvalidAccountPassword.Format Specified account password is not valid.
    400 InstanceClass.NotMatch Current instance class and instance type is not match.
    400 InvalidVPCId.NotFound Specified virtual vpc is not found. A VPC não foi encontrada. Verifique se o ID da VPC está correto.
    400 AccountMoneyValidateError Account money validate error.
    400 RequestTokenConflict Specified request token conflict.
    400 InvalidIPNotInSubnet Error ip not in subnet.
    400 InvalidEngineVersion.Malformed Specified engine version is not valid. A versão do mecanismo DPI é inválida.
    400 Zone.Closed The specified zone is closed.
    400 VSwithNotBelongToNotVpcFault The vSwitch does not belong to current vpc.
    400 PayIllegalAgreement Pay mayi with holding agreement illegal.
    400 IllegalParamError validateSaleConditionWithSubArticle failed.
    400 InvalidRegion.Format Specified Region is not valid. A região especificada é inválida.
    403 RealNameAuthenticationError Your account has not passed the real-name authentication yet.
    403 AuthorizationFailure The request processing has failed due to authorization failure.
    403 TokenServiceError The specified token is duplicated, please change it.
    403 UserCannotBuyNotInnerCommodity The user can not buy this commodity without alibaba group tag.
    404 InvalidCapacity.NotFound The Capacity provided does not exist in our records. A especificação de armazenamento especificada não existe.
    404 InvalidvSwitchId The Specified vSwitchId zone not supported.
    404 InvalidVpcIdOrVswitchId.NotSupported The Specified vpcId or vSwitchId not supported.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.