Partilhar 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 do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e 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

O ID da subscrição de destino. O valor tem de ser um UUID.

api-version
query True

string

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

Corpo do Pedido

Name Necessário Tipo Description
properties.internationalMobileSubscriberIdentity True

string

A identidade internacional de subscritor móvel (IMSI) 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 utilizado para gravar o tipo de dispositivo ao qual este SIM está associado, por exemplo, "Câmara de vídeo". O portal do Azure permite que os SIMs sejam agrupados e filtrados com base neste valor.

properties.integratedCircuitCardIdentifier

string

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

properties.operatorKeyCode

string

O valor Opc para o SIM.

properties.simPolicy

SimPolicyResourceId

A política sim utilizada por este SIM. A política sim tem de estar na mesma localização que o SIM.

properties.staticIpConfiguration

SimStaticIpProperties[]

Uma lista de endereços IP estáticos atribuídos a este SIM. Cada endereço é atribuído num âmbito de rede definido, composto por {rede de dados anexado, segmentação}.

Respostas

Name Tipo Description
200 OK

Sim

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

201 Created

Sim

Create com êxito. A operação devolve o recurso SIM resultante.

Other Status Codes

ErrorResponse

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Create SIM

Pedido de amostra

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 da amostra

{
  "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

Name Description
AttachedDataNetworkResourceId

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

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

ProvisioningState

O estado de aprovisionamento atual.

Sim

Recurso SIM.

SimPolicyResourceId

Referência a um recurso de política sim.

SimState

O estado do recurso SIM.

SimStaticIpProperties

Configuração de IP estático para um SIM, confinada a uma determinada rede de dados anexada e setor.

SliceResourceId

Referência a um recurso de setor.

StaticIp

A configuração de IP estático para o SIM utilizar no âmbito 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.

Name Tipo Description
id

string

ID do recurso de rede de dados anexado.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name 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 a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

ProvisioningState

O estado de aprovisionamento atual.

Name Tipo Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

Sim

Recurso SIM.

Name Tipo Description
id

string

ID de recurso completamente qualificado 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 utilizado para gravar o tipo de dispositivo ao qual este SIM está associado, por exemplo, "Câmara de vídeo". O portal do Azure permite que os SIMs sejam agrupados e filtrados com base neste valor.

properties.integratedCircuitCardIdentifier

string

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

properties.internationalMobileSubscriberIdentity

string

A identidade internacional de subscritor móvel (IMSI) para o SIM.

properties.operatorKeyCode

string

O valor Opc para o SIM.

properties.provisioningState

ProvisioningState

O estado de aprovisionamento do recurso SIM.

properties.simPolicy

SimPolicyResourceId

A política sim utilizada por este SIM. A política sim tem de estar na mesma localização que o SIM.

properties.simState

SimState

O estado do recurso SIM.

properties.siteProvisioningState

object

Um dicionário de sites para o estado de aprovisionamento deste SIM nesse site.

properties.staticIpConfiguration

SimStaticIpProperties[]

Uma lista de endereços IP estáticos atribuídos a este SIM. Cada endereço é atribuído num âmbito de rede definido, composto por {rede de dados anexado, segmentação}.

properties.vendorKeyFingerprint

string

A impressão digital da chave pública do fornecedor do SIM que forneceu este SIM, se aplicável.

properties.vendorName

string

O nome do fornecedor do SIM que forneceu este SIM, se existir.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

type

string

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

SimPolicyResourceId

Referência a um recurso de política sim.

Name Tipo Description
id

string

ID do recurso de política sim.

SimState

O estado do recurso SIM.

Name Tipo Description
Disabled

string

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

Enabled

string

O SIM está ativado.

Invalid

string

Não é possível ativar o SIM porque algumas das configurações associadas são inválidas.

SimStaticIpProperties

Configuração de IP estático para um SIM, confinada a uma determinada rede de dados anexada e setor.

Name Tipo Description
attachedDataNetwork

AttachedDataNetworkResourceId

A rede de dados anexada na qual o endereço IP estático será utilizado. A combinação da rede de dados anexada e do setor define o âmbito de rede do endereço IP. A rede de dados anexada tem de estar na mesma localização que o SIM.

slice

SliceResourceId

O setor de rede no qual o endereço IP estático será utilizado. A combinação da rede de dados anexada e do setor define o âmbito de rede do endereço IP. O setor tem de estar na mesma localização que o SIM.

staticIp

StaticIp

A configuração de IP estático para o SIM utilizar no âmbito de rede definido.

SliceResourceId

Referência a um recurso de setor.

Name Tipo Description
id

string

Segmentar o ID do recurso.

StaticIp

A configuração de IP estático para o SIM utilizar no âmbito de rede definido.

Name Tipo Description
ipv4Address

string

O endereço IPv4 atribuído ao SIM neste âmbito de rede. Este endereço tem de estar no userEquipmentStaticAddressPoolPrefix definido na rede de dados anexada.

systemData

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

Name 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.