Compartilhar via


Cassandra Resources - Create Update Cassandra View

Criar ou atualizar uma exibição do Cassandra do Azure Cosmos DB

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/views/{viewName}?api-version=2025-05-01-preview

Parâmetros de URI

Nome Em Obrigatório Tipo Description
accountName
path True

string

minLength: 3
maxLength: 50
pattern: ^[a-z0-9]+(-[a-z0-9]+)*

Nome da conta de banco de dados do Cosmos DB.

keyspaceName
path True

string

Nome do keyspace do Cosmos DB.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string

minLength: 1

A ID da assinatura de destino.

viewName
path True

string

Nome de exibição do Cosmos DB.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
createUpdateCassandraViewParameters

CassandraViewCreateUpdateParameters

Os parâmetros a serem fornecidos para a exibição do Cassandra atual.

Respostas

Nome Tipo Description
200 OK

CassandraViewGetResults

A operação de criação ou atualização do Modo de Exibição do Cassandra foi concluída com êxito.

202 Accepted

A operação de criação ou atualização do Modo de Exibição do Cassandra será concluída de forma assíncrona.

Cabeçalhos

  • azure-AsyncOperation: string
  • location: string

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation Assumir a identidade da sua conta de usuário

Exemplos

CosmosDBCassandraViewCreateUpdate

Solicitação de exemplo

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspacename/views/viewname?api-version=2025-05-01-preview

{
  "tags": {},
  "properties": {
    "resource": {
      "id": "viewname",
      "viewDefinition": "SELECT columna, columnb, columnc FROM keyspacename.srctablename WHERE columna IS NOT NULL AND columnc IS NOT NULL PRIMARY (columnc, columna)"
    },
    "options": {}
  }
}

Resposta de exemplo

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspacename/views/viewname",
  "name": "viewname",
  "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/views",
  "tags": {},
  "properties": {
    "resource": {
      "id": "viewname",
      "viewDefinition": "SELECT columna, columnb, columnc FROM keyspacename.srctablename WHERE columna IS NOT NULL AND columnc IS NOT NULL PRIMARY KEY (columnc, columna)"
    }
  }
}
azure-AsyncOperation: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/operationsStatus/{operationId}?api-version=2025-05-01-preview
location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/operationsStatus/{operationId}?api-version=2025-05-01-preview

Definições

Nome Description
AutoscaleSettings

Especifica as configurações de Dimensionamento Automático.

CassandraViewCreateUpdateParameters

Os parâmetros a serem fornecidos para a exibição do Cassandra atual.

CassandraViewGetResults

Uma exibição do Cassandra do Azure Cosmos DB.

CassandraViewResource

Objeto de recurso de exibição do Cassandra do Cosmos DB

CreateUpdateOptions

Um par de opções chave-valor a ser aplicado à solicitação. Isso corresponde aos cabeçalhos enviados com a solicitação.

ManagedServiceIdentity

Identidade do recurso.

Options
Resource
ResourceIdentityType

O tipo de identidade.

UserAssignedIdentities

A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

AutoscaleSettings

Especifica as configurações de Dimensionamento Automático.

Nome Tipo Description
maxThroughput

integer

Representa a taxa de transferência máxima, o recurso pode ser escalado verticalmente.

CassandraViewCreateUpdateParameters

Os parâmetros a serem fornecidos para a exibição do Cassandra atual.

Nome Tipo Description
id

string

O identificador de recurso exclusivo do recurso do ARM.

identity

ManagedServiceIdentity

Identidade do recurso.

location

string

O local do grupo de recursos ao qual o recurso pertence.

name

string

O nome do recurso do ARM.

properties.options

CreateUpdateOptions

Um par de opções chave-valor a ser aplicado à solicitação. Isso corresponde aos cabeçalhos enviados com a solicitação.

properties.resource

CassandraViewResource

O formato JSON padrão de uma exibição do Cassandra

tags

object

As marcas são uma lista de pares chave-valor que descrevem o recurso. Essas marcas podem ser usadas na exibição e agrupamento desse recurso (entre grupos de recursos). Um máximo de 15 marcas pode ser fornecido para um recurso. Cada marca deve ter uma chave não maior que 128 caracteres e o valor não seja maior que 256 caracteres. Por exemplo, a experiência padrão para um tipo de modelo é definida com "defaultExperience": "Cassandra". Os valores atuais de "defaultExperience" também incluem "Table", "Graph", "DocumentDB" e "MongoDB".

type

string

O tipo de recurso do Azure.

CassandraViewGetResults

Uma exibição do Cassandra do Azure Cosmos DB.

Nome Tipo Description
id

string

O identificador de recurso exclusivo do recurso do ARM.

identity

ManagedServiceIdentity

Identidade do recurso.

location

string

O local do grupo de recursos ao qual o recurso pertence.

name

string

O nome do recurso do ARM.

properties.options

Options

properties.resource

Resource

tags

object

As marcas são uma lista de pares chave-valor que descrevem o recurso. Essas marcas podem ser usadas na exibição e agrupamento desse recurso (entre grupos de recursos). Um máximo de 15 marcas pode ser fornecido para um recurso. Cada marca deve ter uma chave não maior que 128 caracteres e o valor não seja maior que 256 caracteres. Por exemplo, a experiência padrão para um tipo de modelo é definida com "defaultExperience": "Cassandra". Os valores atuais de "defaultExperience" também incluem "Table", "Graph", "DocumentDB" e "MongoDB".

type

string

O tipo de recurso do Azure.

CassandraViewResource

Objeto de recurso de exibição do Cassandra do Cosmos DB

Nome Tipo Description
id

string

Nome da exibição do Cassandra do Cosmos DB

viewDefinition

string

Exibir definição do modo de exibição do Cassandra do Cosmos DB

CreateUpdateOptions

Um par de opções chave-valor a ser aplicado à solicitação. Isso corresponde aos cabeçalhos enviados com a solicitação.

Nome Tipo Description
autoscaleSettings

AutoscaleSettings

Especifica as configurações de Dimensionamento Automático. Observação: a taxa de transferência ou o dimensionamento automáticoSettings são necessários, mas não ambos.

throughput

integer

Unidades de solicitação por segundo. Por exemplo, "taxa de transferência": 10000.

ManagedServiceIdentity

Identidade do recurso.

Nome Tipo Description
principalId

string

A ID principal da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema.

tenantId

string

A ID do locatário da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema.

type

ResourceIdentityType

O tipo de identidade usado para o recurso. O tipo 'SystemAssigned,UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá as identidades do serviço.

userAssignedIdentities

UserAssignedIdentities

A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Options

Nome Tipo Description
autoscaleSettings

AutoscaleSettings

Especifica as configurações de Dimensionamento Automático.

throughput

integer

Valor da taxa de transferência de recurso do Cosmos DB ou dimensionamentos automáticos. Use o recurso ThroughputSetting ao recuperar detalhes da oferta.

Resource

Nome Tipo Description
_etag

string

Uma propriedade gerada pelo sistema que representa a etag de recurso necessária para o controle de simultaneidade otimista.

_rid

string

Uma propriedade gerada pelo sistema. Um identificador exclusivo.

_ts

number

Uma propriedade gerada pelo sistema que indica o último carimbo de data/hora atualizado do recurso.

id

string

Nome da exibição do Cassandra do Cosmos DB

viewDefinition

string

Exibir definição do modo de exibição do Cassandra do Cosmos DB

ResourceIdentityType

O tipo de identidade.

Valor Description
SystemAssigned

UserAssignedIdentities

A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Nome Tipo Description