Microsoft Azure SDK for Python

这是Microsoft Azure App Platform Management客户端库。此包已与Python 3.8+进行测试。要查看Azure库的完整视图，请参阅azure sdk python release。

免责声明

Azure SDK Python包对Python 2.7的支持已于2022年1月1日结束。有关更多信息及问题，请参阅https://github.com/Azure/azure-sdk-for-python/issues/20691

入门

先决条件

• 使用此包需要Python 3.8+。
• Azure订阅

安装包

pip install azure-mgmt-appplatform
pip install azure-identity

身份验证

默认情况下，Azure Active Directory令牌身份验证依赖于正确配置以下环境变量。

• AZURE_CLIENT_ID用于Azure客户端ID。
• AZURE_TENANT_ID用于Azure租户ID。
• AZURE_CLIENT_SECRET用于Azure客户端密钥。

此外，Azure 订阅 ID 可以通过环境变量 AZURE_SUBSCRIPTION_ID 进行配置。

以上配置后，客户端可以通过以下代码进行认证

from azure.identity import DefaultAzureCredential
from azure.mgmt.appplatform import AppPlatformManagementClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = AppPlatformManagementClient(credential=DefaultAzureCredential(), subscription_id=sub_id)

示例

此包的代码示例可以在以下位置找到

• 在 docs.microsoft.com 上搜索应用程序平台管理
• Azure Python 管理包示例库

故障排除

下一步

提供反馈

如果您遇到任何错误或有建议，请在项目的 问题 部分提交一个问题。

发布历史

9.1.0.post2 (2024-07-12)

其他更改

• 重新发布以适应 setuptools 源代码分发规范化更改。

9.1.0 (2024-07-03)

新增功能

• 添加了操作 ConfigServersOperations.begin_delete
• 添加了操作 ConfigServersOperations.list
• 添加了操作 GatewaysOperations.begin_update_capacity
• 添加了作业执行操作组
• 添加了作业执行操作组
• 添加了作业操作组
• 添加了作业操作组
• 模型 AppResourceProperties 有一个新参数 secrets
• 模型 AppResourceProperties 有一个新参数 test_endpoint_auth_state
• 模型 AppResourceProperties 有一个新参数 workload_profile_name
• 模型 BuildpackProperties 有一个新参数 version
• 模型 ClusterResourceProperties 有一个新参数 infra_resource_group
• 模型 ClusterResourceProperties 有一个新参数 maintenance_schedule_configuration
• 模型 ClusterResourceProperties 有一个新参数 managed_environment_id
• 模型 ConfigServerProperties 有一个新参数 enabled_state
• 模型 ConfigServerProperties 有一个新参数 instances
• 模型 ConfigServerProperties 有一个新参数 resource_requests
• 模型 ConfigurationServiceSettings 有一个新参数 refresh_interval_in_seconds
• 模型 DeploymentSettings 有一个新参数 scale
• 模型 GatewayProperties 有一个新参数 addon_configs
• 模型 GatewayProperties 有一个新参数 apm_types
• 模型 GatewayProperties 有一个新参数 response_cache_properties
• 模型 ServiceResource 有一个新参数 identity
• 模型 ServiceVNetAddons 有一个新参数 private_dns_zone_id
• 模型 ServiceVNetAddons 有一个新参数 private_storage_access
• 模型 SupportedBuildpackResourceProperties 有一个新参数 version
• 操作 DeploymentsOperations.list 有一个新可选参数 expand

9.0.0 (2024-01-26)

新增功能

• 添加了操作 BuildServiceOperations.begin_create_or_update
• 添加了操作 BuildServiceOperations.begin_delete_build
• 添加了操作 ConfigurationServicesOperations.begin_validate_resource
• 添加了操作 GatewaysOperations.begin_restart
• 添加了操作 ServicesOperations.begin_disable_apm_globally
• 添加了操作 ServicesOperations.begin_enable_apm_globally
• 添加了操作 ServicesOperations.begin_flush_vnet_dns_setting
• 添加了操作 ServicesOperations.list_globally_enabled_apms
• 添加了操作 ServicesOperations.list_supported_apm_types
• 添加了操作 ServicesOperations.list_supported_server_versions
• 添加了操作组 ApmsOperations
• 添加了操作组 ContainerRegistriesOperations
• 添加了操作组 EurekaServersOperations
• 模型 AcceleratorBasicAuthSetting 有一个新参数 ca_cert_resource_id
• 模型 AcceleratorGitRepository 有一个新参数 sub_path
• 模型 AcceleratorPublicSetting 有一个新参数 ca_cert_resource_id
• 模型 ApiPortalProperties 有一个新参数 api_try_out_enabled_state
• 模型 BuildProperties 有一个新参数 apms
• 模型 BuildProperties 有一个新参数 certificates
• 模型 BuildResultProperties 有一个新参数 image
• 模型 BuildServiceProperties 有一个新参数 container_registry
• 模型 ConfigurationServiceGitRepository 有一个新参数 ca_cert_resource_id
• 模型 ConfigurationServiceGitRepository 有一个新参数 git_implementation
• 模型 ConfigurationServiceProperties 有一个新参数 generation
• 模型 CustomizedAcceleratorProperties 有一个新参数 accelerator_type
• 模型 CustomizedAcceleratorProperties 有一个新参数 imports
• 模型 DeploymentSettings 有一个新参数 apms
• 模型 DevToolPortalProperties 有一个新参数 components
• 模型 GatewayCorsProperties 有一个新参数 allowed_origin_patterns
• 模型 GatewayProperties 有一个新参数 apms
• 模型 GatewayProperties 有一个新参数 client_auth
• 模型KeyVaultCertificateProperties新增参数auto_sync
• 模型ServiceVNetAddons新增参数data_plane_public_endpoint
• 模型TriggeredBuildResult新增参数image
• 模型TriggeredBuildResult新增参数last_transition_reason
• 模型TriggeredBuildResult新增参数last_transition_status
• 模型TriggeredBuildResult新增参数last_transition_time
• 模型TriggeredBuildResult新增参数provisioning_state
• 操作DeploymentsOperations.list_for_cluster新增可选参数expand

重大变更

• 模型AppResourceProperties不再有参数secrets
• 模型ClusterResourceProperties不再有参数infra_resource_group
• 模型ClusterResourceProperties不再有参数managed_environment_id
• 模型DeploymentSettings不再有参数scale
• 模型DevToolPortalProperties不再有参数instances
• 模型DevToolPortalProperties不再有参数resource_requests
• 模型GatewayProperties不再有参数apm_types
• 移除操作GatewaysOperations.begin_update_capacity
• 将操作CustomizedAcceleratorsOperations.validate重命名为CustomizedAcceleratorsOperations.begin_validate

8.0.0 (2023-04-20)

新增功能

• 添加操作BuildServiceBuilderOperations.list_deployments
• 添加操作BuildpackBindingOperations.list_for_cluster
• 添加操作DeploymentsOperations.begin_disable_remote_debugging
• 添加操作DeploymentsOperations.begin_enable_remote_debugging
• 添加操作DeploymentsOperations.get_remote_debugging_config
• 添加了操作 GatewaysOperations.begin_update_capacity
• 添加操作GatewaysOperations.list_env_secrets
• 添加操作组ApplicationAcceleratorsOperations
• 添加操作组ApplicationLiveViewsOperations
• 添加操作组CustomizedAcceleratorsOperations
• 添加操作组DevToolPortalsOperations
• 添加操作组PredefinedAcceleratorsOperations
• 模型AppResourceProperties新增参数ingress_settings
• 模型 AppResourceProperties 有一个新参数 secrets
• 模型AzureFileVolume新增参数enable_sub_path
• 模型BuildResultProperties新增参数error
• 模型BuildStageProperties新增参数exit_code
• 模型BuildStageProperties新增参数reason
• 模型 ClusterResourceProperties 有一个新参数 infra_resource_group
• 模型 ClusterResourceProperties 有一个新参数 managed_environment_id
• 模型CustomPersistentDiskProperties新增参数enable_sub_path
• 模型 DeploymentSettings 有一个新参数 scale
• 模型 GatewayProperties 有一个新参数 apm_types
• 模型GatewayProperties新增参数environment_variables
• 模型GatewayRouteConfigProperties新增参数filters
• 模型GatewayRouteConfigProperties新增参数predicates
• 模型GatewayRouteConfigProperties新增参数protocol
• 模型GatewayRouteConfigProperties新增参数sso_enabled
• 模型NetworkProfile新增参数outbound_type

8.0.0b1（2023-02-13）

新增功能

• 添加操作BuildServiceBuilderOperations.list_deployments
• 添加操作DeploymentsOperations.begin_disable_remote_debugging
• 添加操作DeploymentsOperations.begin_enable_remote_debugging
• 添加操作DeploymentsOperations.get_remote_debugging_config
• 添加操作组ApplicationAcceleratorsOperations
• 添加操作组ApplicationLiveViewsOperations
• 添加操作组CustomizedAcceleratorsOperations
• 添加操作组DevToolPortalsOperations
• 添加操作组PredefinedAcceleratorsOperations
• 模型AppResourceProperties新增参数ingress_settings
• 模型GatewayRouteConfigProperties新增参数protocol
• 模型NetworkProfile新增参数outbound_type

重大变更

• 模型ClusterResourceProperties不再有参数marketplace_resource

7.1.0 (2022-05-16)

功能特性

• 模型AppResourceProperties新增参数vnet_addons
• 模型BuildProperties新增参数resource_requests
• 模型CertificateProperties新增参数provisioning_state
• 模型ClusterResourceProperties新增参数marketplace_resource
• 模型ClusterResourceProperties新增参数vnet_addons
• 模型ContentCertificateProperties新增参数provisioning_state
• 模型CustomContainer新增参数language_framework
• 模型CustomDomainProperties新增参数provisioning_state
• 模型DeploymentSettings新增参数liveness_probe
• 模型DeploymentSettings新增参数readiness_probe
• 模型DeploymentSettings新增参数startup_probe
• 模型DeploymentSettings新增参数termination_grace_period_seconds
• 模型GatewayRouteConfigProperties新增参数open_api
• 模型KeyVaultCertificateProperties新增参数provisioning_state
• 模型ManagedIdentityProperties新增参数user_assigned_identities
• 模型NetworkProfile新增参数ingress_config

7.0.0 (2022-02-22)

功能特性

• 添加操作AppsOperations.begin_set_active_deployments
• 添加操作DeploymentsOperations.begin_generate_heap_dump
• 添加操作DeploymentsOperations.begin_generate_thread_dump
• 添加操作DeploymentsOperations.begin_start_jfr
• 添加操作ServicesOperations.begin_start
• 添加操作ServicesOperations.begin_stop
• 添加操作组ApiPortalCustomDomainsOperations
• 添加操作组ApiPortalsOperations
• 添加操作组BuildServiceAgentPoolOperations
• 添加操作组BuildServiceBuilderOperations
• 添加操作组BuildServiceOperations
• 添加操作组BuildpackBindingOperations
• 添加操作组ConfigurationServicesOperations
• 添加操作组GatewayCustomDomainsOperations
• 添加了操作组 GatewayRouteConfigsOperations
• 添加了操作组 GatewaysOperations
• 添加了操作组 ServiceRegistriesOperations
• 添加了操作组 StoragesOperations
• 模型 AppResource 新增参数 system_data
• 模型 AppResourceProperties 新增参数 addon_configs
• 模型 AppResourceProperties 新增参数 custom_persistent_disks
• 模型 AppResourceProperties 新增参数 loaded_certificates
• 模型 BindingResource 新增参数 system_data
• 模型 CertificateResource 新增参数 system_data
• 模型 ClusterResourceProperties 新增参数 fqdn
• 模型 ClusterResourceProperties 新增参数 power_state
• 模型 ClusterResourceProperties 新增参数 zone_redundant
• 模型 ConfigServerResource 新增参数 system_data
• 模型 CustomDomainResource 新增参数 system_data
• 模型 DeploymentInstance 新增参数 zone
• 模型 DeploymentResource 新增参数 system_data
• 模型 DeploymentSettings 新增参数 addon_configs
• 模型 DeploymentSettings 新增参数 container_probe_settings
• 模型 MetricSpecification 新增参数 source_mdm_namespace
• 模型 MonitoringSettingResource 新增参数 system_data
• 模型 OperationDetail 新增参数 action_type
• 模型 ProxyResource 新增参数 system_data
• 模型 Resource 新增参数 system_data
• 模型 ServiceResource 新增参数 system_data
• 模型 TrackedResource 新增参数 system_data

重大变更

• 模型 AppResourceProperties 不再包含参数 active_deployment_name
• 模型 AppResourceProperties 不再包含参数 created_time
• 模型 CertificateProperties 新增必填参数 type
• 模型 CertificateProperties 不再包含参数 cert_version
• 模型 CertificateProperties 不再包含参数 key_vault_cert_name
• 模型 CertificateProperties 不再包含参数 vault_uri
• 模型 DeploymentResourceProperties 不再包含参数 app_name
• 模型 DeploymentResourceProperties 不再包含参数 created_time
• 模型 DeploymentSettings 不再包含参数 cpu
• 模型 DeploymentSettings 不再包含参数 jvm_options
• 模型 DeploymentSettings 不再包含参数 memory_in_gb
• 模型 DeploymentSettings 不再包含参数 net_core_main_entry_path
• 模型 DeploymentSettings 不再包含参数 runtime_version
• 模型 UserSourceInfo 不再包含参数 artifact_selector
• 模型 UserSourceInfo 不再包含参数 custom_container
• 模型 UserSourceInfo 不再包含参数 relative_path
• 模型 UserSourceInfo 的参数类型现在为必填
• 移除了操作组 SkuOperations

6.1.0 (2021-07-09)

功能特性

• 模型 UserSourceInfo 新增参数 custom_container
• 模型 MetricDimension 新增参数 to_be_exported_for_shoebox
• 模型 DeploymentSettings 新增参数 resource_requests

6.0.0 (2021-04-08)

功能特性

• 模型 MonitoringSettingProperties 新增参数 app_insights_agent_versions
• 模型 MonitoringSettingProperties 新增参数 app_insights_sampling_rate
• 模型 AppResourceProperties 新增参数 enable_end_to_end_tls
• 模型 NetworkProfile 新增参数 required_traffics

6.0.0b1 (2020-12-03)

这是beta预览版本。

本版本使用新一代代码生成器，引入了重要的重大变更，但也引入了重要的新功能（如统一身份验证和异步编程）。

一般重大变更

• 凭证系统已完全重造

  • azure.common.credentials 或 msrestazure.azure_active_directory 实例不再受支持，请使用 azure-identity 类：[https://pypi.ac.cn/project/azure-identity/](https://pypi.ac.cn/project/azure-identity/)
  • credentials 参数已重命名为 credential

• 客户端上的 config 属性不再存在，配置应作为 kwarg 传递。示例：MyClient(credential, subscription_id, enable_logging=True)。有关支持的完整选项，请参阅azure-core 初始化文档中的参数接受

• 无法再导入 version 模块，请使用 __version__ 代替

• 以前返回msrest.polling.LROPoller的操作现在返回azure.core.polling.LROPoller，并以begin_为前缀。

• 异常树已被简化，大多数异常现在为azure.core.exceptions.HttpResponseError（已删除CloudError）。

• 大多数操作关键字段已更改。一些最显著的更改是

  • raw已被删除。等效功能可以通过使用cls找到，它是一个回调，将允许高级用户访问内部HTTP响应。
  • 有关支持选项的完整集，请参阅azure-core请求文档中的参数接受

通用新功能

• 支持使用typing进行类型注解。SDKs已准备好使用mypy。
• 此客户端现在对异步操作具有稳定且官方的支持。检查您包的aio命名空间以查找异步客户端。
• 此客户端现在原生支持OpenCensus或OpenTelemetry等跟踪库。请参阅此跟踪快速入门以获取概述。

1.0.0 (2020-08-25)

• 初始API版本发布

0.1.0 (2019-10-25)

• 其他预发布API更改

0.1.0rc1（2019-10-24）

• 初始发布