Skip to content
Cloudflare API
Start here
API Reference
Magic Cloud Networking

Cloud Integrations

List Cloud Integrations
magic_cloud_networking.cloud_integrations.list(CloudIntegrationListParams**kwargs) -> SyncSinglePage[CloudIntegrationListResponse]
GET/accounts/{account_id}/magic/cloud/providers
Read Cloud Integration
magic_cloud_networking.cloud_integrations.get(strprovider_id, CloudIntegrationGetParams**kwargs) -> CloudIntegrationGetResponse
GET/accounts/{account_id}/magic/cloud/providers/{provider_id}
Create Cloud Integration
magic_cloud_networking.cloud_integrations.create(CloudIntegrationCreateParams**kwargs) -> CloudIntegrationCreateResponse
POST/accounts/{account_id}/magic/cloud/providers
Update Cloud Integration
magic_cloud_networking.cloud_integrations.update(strprovider_id, CloudIntegrationUpdateParams**kwargs) -> CloudIntegrationUpdateResponse
PUT/accounts/{account_id}/magic/cloud/providers/{provider_id}
Patch Cloud Integration
magic_cloud_networking.cloud_integrations.edit(strprovider_id, CloudIntegrationEditParams**kwargs) -> CloudIntegrationEditResponse
PATCH/accounts/{account_id}/magic/cloud/providers/{provider_id}
Delete Cloud Integration
magic_cloud_networking.cloud_integrations.delete(strprovider_id, CloudIntegrationDeleteParams**kwargs) -> CloudIntegrationDeleteResponse
DELETE/accounts/{account_id}/magic/cloud/providers/{provider_id}
Run Discovery for All Integrations
magic_cloud_networking.cloud_integrations.discover_all(CloudIntegrationDiscoverAllParams**kwargs) -> CloudIntegrationDiscoverAllResponse
POST/accounts/{account_id}/magic/cloud/providers/discover
Run Discovery
magic_cloud_networking.cloud_integrations.discover(strprovider_id, CloudIntegrationDiscoverParams**kwargs) -> CloudIntegrationDiscoverResponse
POST/accounts/{account_id}/magic/cloud/providers/{provider_id}/discover
Get Cloud Integration Setup Config
magic_cloud_networking.cloud_integrations.initial_setup(strprovider_id, CloudIntegrationInitialSetupParams**kwargs) -> CloudIntegrationInitialSetupResponse
GET/accounts/{account_id}/magic/cloud/providers/{provider_id}/initial_setup
ModelsExpand Collapse
class CloudIntegrationListResponse: …
id: str
formatuuid
cloud_type: Literal["AWS", "AZURE", "GOOGLE", "CLOUDFLARE"]
One of the following:
"AWS"
"AZURE"
"GOOGLE"
"CLOUDFLARE"
friendly_name: str
last_updated: str
lifecycle_state: Literal["ACTIVE", "PENDING_SETUP", "RETIRED"]
One of the following:
"ACTIVE"
"PENDING_SETUP"
"RETIRED"
state: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
state_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
aws_arn: Optional[str]
azure_subscription_id: Optional[str]
azure_tenant_id: Optional[str]
description: Optional[str]
gcp_project_id: Optional[str]
gcp_service_account_email: Optional[str]
status: Optional[Status]
discovery_progress: StatusDiscoveryProgress
done: int
total: int
unit: str
discovery_progress_v2: StatusDiscoveryProgressV2
done: int
total: int
unit: str
last_discovery_status: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
last_discovery_status_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
regions: List[str]
credentials_good_since: Optional[str]
credentials_missing_since: Optional[str]
credentials_rejected_since: Optional[str]
discovery_message: Optional[str]
discovery_message_v2: Optional[str]
in_use_by: Optional[List[StatusInUseBy]]
id: str
formatuuid
client_type: Literal["MAGIC_WAN_CLOUD_ONRAMP"]
name: str
last_discovery_completed_at: Optional[str]
last_discovery_completed_at_v2: Optional[str]
last_discovery_started_at: Optional[str]
last_discovery_started_at_v2: Optional[str]
last_updated: Optional[str]
class CloudIntegrationGetResponse: …
id: str
formatuuid
cloud_type: Literal["AWS", "AZURE", "GOOGLE", "CLOUDFLARE"]
One of the following:
"AWS"
"AZURE"
"GOOGLE"
"CLOUDFLARE"
friendly_name: str
last_updated: str
lifecycle_state: Literal["ACTIVE", "PENDING_SETUP", "RETIRED"]
One of the following:
"ACTIVE"
"PENDING_SETUP"
"RETIRED"
state: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
state_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
aws_arn: Optional[str]
azure_subscription_id: Optional[str]
azure_tenant_id: Optional[str]
description: Optional[str]
gcp_project_id: Optional[str]
gcp_service_account_email: Optional[str]
status: Optional[Status]
discovery_progress: StatusDiscoveryProgress
done: int
total: int
unit: str
discovery_progress_v2: StatusDiscoveryProgressV2
done: int
total: int
unit: str
last_discovery_status: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
last_discovery_status_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
regions: List[str]
credentials_good_since: Optional[str]
credentials_missing_since: Optional[str]
credentials_rejected_since: Optional[str]
discovery_message: Optional[str]
discovery_message_v2: Optional[str]
in_use_by: Optional[List[StatusInUseBy]]
id: str
formatuuid
client_type: Literal["MAGIC_WAN_CLOUD_ONRAMP"]
name: str
last_discovery_completed_at: Optional[str]
last_discovery_completed_at_v2: Optional[str]
last_discovery_started_at: Optional[str]
last_discovery_started_at_v2: Optional[str]
last_updated: Optional[str]
class CloudIntegrationCreateResponse: …
id: str
formatuuid
cloud_type: Literal["AWS", "AZURE", "GOOGLE", "CLOUDFLARE"]
One of the following:
"AWS"
"AZURE"
"GOOGLE"
"CLOUDFLARE"
friendly_name: str
last_updated: str
lifecycle_state: Literal["ACTIVE", "PENDING_SETUP", "RETIRED"]
One of the following:
"ACTIVE"
"PENDING_SETUP"
"RETIRED"
state: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
state_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
aws_arn: Optional[str]
azure_subscription_id: Optional[str]
azure_tenant_id: Optional[str]
description: Optional[str]
gcp_project_id: Optional[str]
gcp_service_account_email: Optional[str]
status: Optional[Status]
discovery_progress: StatusDiscoveryProgress
done: int
total: int
unit: str
discovery_progress_v2: StatusDiscoveryProgressV2
done: int
total: int
unit: str
last_discovery_status: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
last_discovery_status_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
regions: List[str]
credentials_good_since: Optional[str]
credentials_missing_since: Optional[str]
credentials_rejected_since: Optional[str]
discovery_message: Optional[str]
discovery_message_v2: Optional[str]
in_use_by: Optional[List[StatusInUseBy]]
id: str
formatuuid
client_type: Literal["MAGIC_WAN_CLOUD_ONRAMP"]
name: str
last_discovery_completed_at: Optional[str]
last_discovery_completed_at_v2: Optional[str]
last_discovery_started_at: Optional[str]
last_discovery_started_at_v2: Optional[str]
last_updated: Optional[str]
class CloudIntegrationUpdateResponse: …
id: str
formatuuid
cloud_type: Literal["AWS", "AZURE", "GOOGLE", "CLOUDFLARE"]
One of the following:
"AWS"
"AZURE"
"GOOGLE"
"CLOUDFLARE"
friendly_name: str
last_updated: str
lifecycle_state: Literal["ACTIVE", "PENDING_SETUP", "RETIRED"]
One of the following:
"ACTIVE"
"PENDING_SETUP"
"RETIRED"
state: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
state_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
aws_arn: Optional[str]
azure_subscription_id: Optional[str]
azure_tenant_id: Optional[str]
description: Optional[str]
gcp_project_id: Optional[str]
gcp_service_account_email: Optional[str]
status: Optional[Status]
discovery_progress: StatusDiscoveryProgress
done: int
total: int
unit: str
discovery_progress_v2: StatusDiscoveryProgressV2
done: int
total: int
unit: str
last_discovery_status: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
last_discovery_status_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
regions: List[str]
credentials_good_since: Optional[str]
credentials_missing_since: Optional[str]
credentials_rejected_since: Optional[str]
discovery_message: Optional[str]
discovery_message_v2: Optional[str]
in_use_by: Optional[List[StatusInUseBy]]
id: str
formatuuid
client_type: Literal["MAGIC_WAN_CLOUD_ONRAMP"]
name: str
last_discovery_completed_at: Optional[str]
last_discovery_completed_at_v2: Optional[str]
last_discovery_started_at: Optional[str]
last_discovery_started_at_v2: Optional[str]
last_updated: Optional[str]
class CloudIntegrationEditResponse: …
id: str
formatuuid
cloud_type: Literal["AWS", "AZURE", "GOOGLE", "CLOUDFLARE"]
One of the following:
"AWS"
"AZURE"
"GOOGLE"
"CLOUDFLARE"
friendly_name: str
last_updated: str
lifecycle_state: Literal["ACTIVE", "PENDING_SETUP", "RETIRED"]
One of the following:
"ACTIVE"
"PENDING_SETUP"
"RETIRED"
state: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
state_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
aws_arn: Optional[str]
azure_subscription_id: Optional[str]
azure_tenant_id: Optional[str]
description: Optional[str]
gcp_project_id: Optional[str]
gcp_service_account_email: Optional[str]
status: Optional[Status]
discovery_progress: StatusDiscoveryProgress
done: int
total: int
unit: str
discovery_progress_v2: StatusDiscoveryProgressV2
done: int
total: int
unit: str
last_discovery_status: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
last_discovery_status_v2: Literal["UNSPECIFIED", "PENDING", "DISCOVERING", 2 more]
One of the following:
"UNSPECIFIED"
"PENDING"
"DISCOVERING"
"FAILED"
"SUCCEEDED"
regions: List[str]
credentials_good_since: Optional[str]
credentials_missing_since: Optional[str]
credentials_rejected_since: Optional[str]
discovery_message: Optional[str]
discovery_message_v2: Optional[str]
in_use_by: Optional[List[StatusInUseBy]]
id: str
formatuuid
client_type: Literal["MAGIC_WAN_CLOUD_ONRAMP"]
name: str
last_discovery_completed_at: Optional[str]
last_discovery_completed_at_v2: Optional[str]
last_discovery_started_at: Optional[str]
last_discovery_started_at_v2: Optional[str]
last_updated: Optional[str]
class CloudIntegrationDeleteResponse: …
id: str
formatuuid
class CloudIntegrationDiscoverAllResponse: …
errors: List[Error]
maxLength0
code: Literal[1001, 1002, 1003, 152 more]
One of the following:
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
3001
3002
3003
3004
3005
3006
3007
4001
4002
4003
4004
4005
4006
4007
4008
4009
4010
4011
4012
4013
4014
4015
4016
4017
4018
4019
4020
4021
4022
4023
5001
5002
5003
5004
102000
102001
102002
102003
102004
102005
102006
102007
102008
102009
102010
102011
102012
102013
102014
102015
102016
102017
102018
102019
102020
102021
102022
102023
102024
102025
102026
102027
102028
102029
102030
102031
102032
102033
102034
102035
102036
102037
102038
102039
102040
102041
102042
102043
102044
102045
102046
102047
102048
102049
102050
102051
102052
102053
102054
102055
102056
102057
102058
102059
102060
102061
102062
102063
102064
102065
102066
102067
102068
102069
102070
102071
102072
103001
103002
103003
103004
103005
103006
103007
103008
message: str
documentation_url: Optional[str]
meta: Optional[ErrorMeta]
l10n_key: Optional[str]
loggable_error: Optional[str]
template_data: Optional[object]
trace_id: Optional[str]
source: Optional[ErrorSource]
parameter: Optional[str]
parameter_value_index: Optional[int]
pointer: Optional[str]
messages: List[Message]
code: Literal[1001, 1002, 1003, 152 more]
One of the following:
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
3001
3002
3003
3004
3005
3006
3007
4001
4002
4003
4004
4005
4006
4007
4008
4009
4010
4011
4012
4013
4014
4015
4016
4017
4018
4019
4020
4021
4022
4023
5001
5002
5003
5004
102000
102001
102002
102003
102004
102005
102006
102007
102008
102009
102010
102011
102012
102013
102014
102015
102016
102017
102018
102019
102020
102021
102022
102023
102024
102025
102026
102027
102028
102029
102030
102031
102032
102033
102034
102035
102036
102037
102038
102039
102040
102041
102042
102043
102044
102045
102046
102047
102048
102049
102050
102051
102052
102053
102054
102055
102056
102057
102058
102059
102060
102061
102062
102063
102064
102065
102066
102067
102068
102069
102070
102071
102072
103001
103002
103003
103004
103005
103006
103007
103008
message: str
documentation_url: Optional[str]
meta: Optional[MessageMeta]
l10n_key: Optional[str]
loggable_error: Optional[str]
template_data: Optional[object]
trace_id: Optional[str]
source: Optional[MessageSource]
parameter: Optional[str]
parameter_value_index: Optional[int]
pointer: Optional[str]
success: bool
class CloudIntegrationDiscoverResponse: …
errors: List[Error]
maxLength0
code: Literal[1001, 1002, 1003, 152 more]
One of the following:
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
3001
3002
3003
3004
3005
3006
3007
4001
4002
4003
4004
4005
4006
4007
4008
4009
4010
4011
4012
4013
4014
4015
4016
4017
4018
4019
4020
4021
4022
4023
5001
5002
5003
5004
102000
102001
102002
102003
102004
102005
102006
102007
102008
102009
102010
102011
102012
102013
102014
102015
102016
102017
102018
102019
102020
102021
102022
102023
102024
102025
102026
102027
102028
102029
102030
102031
102032
102033
102034
102035
102036
102037
102038
102039
102040
102041
102042
102043
102044
102045
102046
102047
102048
102049
102050
102051
102052
102053
102054
102055
102056
102057
102058
102059
102060
102061
102062
102063
102064
102065
102066
102067
102068
102069
102070
102071
102072
103001
103002
103003
103004
103005
103006
103007
103008
message: str
documentation_url: Optional[str]
meta: Optional[ErrorMeta]
l10n_key: Optional[str]
loggable_error: Optional[str]
template_data: Optional[object]
trace_id: Optional[str]
source: Optional[ErrorSource]
parameter: Optional[str]
parameter_value_index: Optional[int]
pointer: Optional[str]
messages: List[Message]
code: Literal[1001, 1002, 1003, 152 more]
One of the following:
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
3001
3002
3003
3004
3005
3006
3007
4001
4002
4003
4004
4005
4006
4007
4008
4009
4010
4011
4012
4013
4014
4015
4016
4017
4018
4019
4020
4021
4022
4023
5001
5002
5003
5004
102000
102001
102002
102003
102004
102005
102006
102007
102008
102009
102010
102011
102012
102013
102014
102015
102016
102017
102018
102019
102020
102021
102022
102023
102024
102025
102026
102027
102028
102029
102030
102031
102032
102033
102034
102035
102036
102037
102038
102039
102040
102041
102042
102043
102044
102045
102046
102047
102048
102049
102050
102051
102052
102053
102054
102055
102056
102057
102058
102059
102060
102061
102062
102063
102064
102065
102066
102067
102068
102069
102070
102071
102072
103001
103002
103003
103004
103005
103006
103007
103008
message: str
documentation_url: Optional[str]
meta: Optional[MessageMeta]
l10n_key: Optional[str]
loggable_error: Optional[str]
template_data: Optional[object]
trace_id: Optional[str]
source: Optional[MessageSource]
parameter: Optional[str]
parameter_value_index: Optional[int]
pointer: Optional[str]
success: bool
One of the following:
class McnAwsTrustPolicy: …
aws_trust_policy: str
item_type: str
class McnAzureSetup: …
integration_identity_tag: str
item_type: str
tag_cli_command: str
class McnGcpSetup: …
integration_identity_tag: str
item_type: str
tag_cli_command: str