Compartilhar via


Sims - Create Or Update

Cria ou atualiza um SIM.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/sims/{simName}?api-version=2024-04-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
path True

string

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

simGroupName
path True

string

O nome do Grupo SIM.

Padrão Regex: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

simName
path True

string

O nome do SIM.

Padrão Regex: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

subscriptionId
path True

string

uuid

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

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

Corpo da solicitação

Nome Obrigatório Tipo Description
properties.internationalMobileSubscriberIdentity True

string

A IMSI (identidade internacional do assinante móvel) para o SIM.

properties.authenticationKey

string

O valor ki para o SIM.

properties.deviceType

string

Um campo de texto de forma livre opcional que pode ser usado para gravar o tipo de dispositivo ao qual esse SIM está associado, por exemplo, "Câmera de vídeo". O portal do Azure permite que os SIMs sejam agrupados e filtrados com base nesse valor.

properties.integratedCircuitCardIdentifier

string

O circuito integrado cartão ID (ICCID) para o SIM.

properties.operatorKeyCode

string

O valor Opc para o SIM.

properties.simPolicy

SimPolicyResourceId

A política sim usada por esse SIM. A política do SIM deve estar no mesmo local que o SIM.

properties.staticIpConfiguration

SimStaticIpProperties[]

Uma lista de endereços IP estáticos atribuídos a esse SIM. Cada endereço é atribuído em um escopo de rede definido, composto por {rede de dados anexada, slice}.

Respostas

Nome Tipo Description
200 OK

Sim

Atualização bem-sucedida. A operação retorna o recurso SIM resultante.

201 Created

Sim

Create bem-sucedido. A operação retorna o recurso SIM resultante.

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

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 representar sua conta de usuário

Exemplos

Create SIM

Solicitação de exemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2024-04-01

{
  "properties": {
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "authenticationKey": "00000000000000000000000000000000",
    "operatorKeyCode": "00000000000000000000000000000000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

Resposta de exemplo

{
  "name": "testSim",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
  "type": "Microsoft.MobileNetwork/simGroups/sims",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "simState": "Enabled",
    "siteProvisioningState": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Provisioned",
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Provisioned"
    },
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
  "name": "testSim",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
  "type": "Microsoft.MobileNetwork/simGroups/sims",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Created",
    "simState": "Enabled",
    "siteProvisioningState": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Adding",
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Adding"
    },
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

Definições

Nome Description
AttachedDataNetworkResourceId

Referência a um recurso de rede de dados anexado.

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ProvisioningState

O estado de provisionamento atual.

Sim

Recurso SIM.

SimPolicyResourceId

Referência a um recurso de política do SIM.

SimState

O estado do recurso SIM.

SimStaticIpProperties

Configuração de IP estático para um SIM, com escopo para uma determinada rede de dados anexada e uma fatia.

SliceResourceId

Referência a um recurso de fatia.

StaticIp

A configuração de IP estático para o SIM usar no escopo de rede definido.

systemData

Metadados relativos à criação e à última modificação do recurso.

AttachedDataNetworkResourceId

Referência a um recurso de rede de dados anexado.

Nome Tipo Description
id

string

ID do recurso de rede de dados anexada.

createdByType

O tipo de identidade que criou o recurso.

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

ProvisioningState

O estado de provisionamento atual.

Nome Tipo Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

Sim

Recurso SIM.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.authenticationKey

string

O valor ki para o SIM.

properties.deviceType

string

Um campo de texto de forma livre opcional que pode ser usado para gravar o tipo de dispositivo ao qual esse SIM está associado, por exemplo, "Câmera de vídeo". O portal do Azure permite que os SIMs sejam agrupados e filtrados com base nesse valor.

properties.integratedCircuitCardIdentifier

string

O circuito integrado cartão ID (ICCID) para o SIM.

properties.internationalMobileSubscriberIdentity

string

A IMSI (identidade internacional do assinante móvel) para o SIM.

properties.operatorKeyCode

string

O valor Opc para o SIM.

properties.provisioningState

ProvisioningState

O estado de provisionamento do recurso SIM.

properties.simPolicy

SimPolicyResourceId

A política sim usada por esse SIM. A política do SIM deve estar no mesmo local que o SIM.

properties.simState

SimState

O estado do recurso SIM.

properties.siteProvisioningState

object

Um dicionário de sites para o estado de provisionamento desse SIM nesse site.

properties.staticIpConfiguration

SimStaticIpProperties[]

Uma lista de endereços IP estáticos atribuídos a esse SIM. Cada endereço é atribuído em um escopo de rede definido, composto por {rede de dados anexada, slice}.

properties.vendorKeyFingerprint

string

O impressão digital da chave público do fornecedor do SIM que forneceu esse SIM, se houver.

properties.vendorName

string

O nome do fornecedor do SIM que forneceu esse SIM, se houver.

systemData

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.

type

string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SimPolicyResourceId

Referência a um recurso de política do SIM.

Nome Tipo Description
id

string

ID do recurso de política do SIM.

SimState

O estado do recurso SIM.

Nome Tipo Description
Disabled

string

O SIM está desabilitado porque nem toda a configuração necessária para habilitação está presente.

Enabled

string

O SIM está habilitado.

Invalid

string

O SIM não pode ser habilitado porque parte da configuração associada é inválida.

SimStaticIpProperties

Configuração de IP estático para um SIM, com escopo para uma determinada rede de dados anexada e uma fatia.

Nome Tipo Description
attachedDataNetwork

AttachedDataNetworkResourceId

A rede de dados anexada na qual o endereço IP estático será usado. A combinação de rede de dados anexada e fatia define o escopo de rede do endereço IP. A rede de dados anexada deve estar no mesmo local que o SIM.

slice

SliceResourceId

A fatia de rede na qual o endereço IP estático será usado. A combinação de rede de dados anexada e fatia define o escopo de rede do endereço IP. A fatia deve estar no mesmo local que o SIM.

staticIp

StaticIp

A configuração de IP estático para o SIM usar no escopo de rede definido.

SliceResourceId

Referência a um recurso de fatia.

Nome Tipo Description
id

string

ID do recurso de fatia.

StaticIp

A configuração de IP estático para o SIM usar no escopo de rede definido.

Nome Tipo Description
ipv4Address

string

O endereço IPv4 atribuído ao SIM neste escopo de rede. Esse endereço deve estar no userEquipmentStaticAddressPoolPrefix definido na rede de dados anexada.

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.