Skip to content

Commit b9ddd4b

Browse files
v-dirichardsv-dirichards
authored
Merge pull request #314488 from v-thepet/sc11
Freshness Edit: Service Connector 11
2 parents 4ae4b54 + 45c699e commit b9ddd4b

1 file changed

Lines changed: 46 additions & 43 deletions

File tree

‎articles/service-connector/how-to-troubleshoot-front-end-error.md‎

Lines changed: 46 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,68 @@
11
---
2-
title: Service Connector troubleshooting guidance
3-
description: This article lists error messages and suggested actions to troubleshooting issues with Service Connector.
2+
title: Service Connector troubleshooting
3+
description: See error messages and suggested actions for troubleshooting issues with Service Connector.
44
author: maud-lv
55
ms.author: malev
66
ms.service: service-connector
77
ms.topic: troubleshooting
8-
ms.date: 10/19/2023
8+
ms.date: 04/09/2026
99
ms.custom: kr2b-contr-experiment, devx-track-azurecli
10+
#customer intent: As a Service Connector user, I need to understand the Service Connector error messages and suggested actions so I can use them to troubleshoot Service Connector.
1011
---
1112

12-
# How to troubleshoot Service Connector
13+
# Service Connector troubleshooting
1314

14-
This article lists error messages and suggestions to troubleshoot Service Connector.
15+
This article lists Service Connector error messages you might encounter in the Azure portal or Azure CLI, and suggests actions you can take to troubleshoot them.
1516

16-
## Error message and suggested actions from the Azure portal
17+
## Azure portal
1718

18-
| Error message | Suggested Action |
19-
|-----------------------|-----------------------------------------------------------------------------------------------------------|
20-
| Unknown resource type | Check source and target resource to verify whether the service types are supported by Service Connector. |
21-
| | Check whether the specified source-target connection combination is supported by Service Connector. |
22-
| | Check whether the target resource exists. |
23-
| | Check the correctness of the target resource ID. |
24-
| Unsupported resource | Check whether the authentication type is supported by the specified source-target connection combination. |
19+
The following Service Connector errors can occur in the Azure portal.
2520

26-
## Error type，error message, and suggested actions using Azure CLI
21+
### Unknown resource type
2722

28-
### InvalidArgumentValueError
23+
To troubleshoot, make sure that:
2924

30-
| Error message | Suggested Action |
31-
|-------------------------------------------------|--------------------------------------------------------------------------|
32-
| The source resource ID is invalid: `{SourceId}` | Check whether the source resource ID supported by Service Connector. |
33-
| | Check the correctness of source resource ID. |
34-
| Target resource ID is invalid: `{TargetId}` | Check whether the target service type is supported by Service Connector. |
35-
| | Check the correctness of target resource ID. |
36-
| Connection ID is invalid: `{ConnectionId}` | Check the correctness of the connection ID. |
25+
- Service Connector supports the source and target resource service types.
26+
- Service Connector supports the specified source-target connection combination.
27+
- The target resource exists.
28+
- The target resource ID is correct.
3729

38-
#### RequiredArgumentMissingError
30+
### Unsupported resource
3931

40-
| Error message | Suggested Action |
41-
|------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
42-
| `{Argument}` shouldn't be blank | User should provide argument value for interactive input |
43-
| Required keys missing for parameter `{Parameter}`. All possible keys are: `{Keys}` | Provide value for the authentication information parameter, usually in the form of `--param key1=val1 key2=val2`. |
44-
| Required argument is missing, please provide the arguments: `{Arguments}` | Provide the required argument. |
32+
To troubleshoot, make sure that the selected authentication type supports the specified source-target connection combination.
4533

46-
#### ValidationError
34+
## Azure CLI
4735

48-
| Error message | Suggested Action |
49-
|----------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
50-
| Only one auth info is needed | User can only provide one authentication information parameter. Check whether it isn't provided or multiple parameters are provided. |
51-
| Auth info argument should be provided when updating the connection: `{ConnectionName}` | The authentication information should be provided when updating a secret type connection. This error occurs because a user's secret can't be accessed through the Azure Resource Manager API. |
52-
| Either client type or auth info should be specified to update | Either client type or authentication information should be provided when updating a connection. |
53-
| Usage error: `{} [KEY=VALUE ...]` | Check the available keys and provide values for the auth info parameter, usually in the form of `--param key1=val1 key2=val2`. |
54-
| Unsupported Key `{Key}` is provided for parameter `{Parameter}`. All possible keys are: `{Keys}` | Check the available keys and provide values for the authentication information parameter, usually in the form of `--param key1=val1 key2=val2`. |
55-
| Provision failed, please create the target resource manually and then create the connection. Error details: `{ErrorTrace}` | Retry. Create the target resource manually and then create the connection. |
36+
The following Service Connector errors can occur in Azure CLI.
5637

57-
## Next steps
38+
### InvalidArgumentValue errors
5839

59-
Follow the tutorials listed below to learn more about Service Connector.
40+
| Error message | Suggested action |
41+
|--------------------|-----------------------------|
42+
| `The source resource ID is invalid: {SourceId}` | - Make sure Service Connector supports the source resource ID.<br> - Make sure the source resource ID is correct. |
43+
| `Target resource ID is invalid: {TargetId}` | - Make sure Service Connector supports the target service type.<br> - Make sure the target resource ID is correct. |
44+
| `Connection ID is invalid: {ConnectionId}` | Make sure the connection ID is correct. |
6045

61-
> [!div class="nextstepaction"]
62-
> [Learn about Service Connector concepts](./concept-service-connector-internals.md)
46+
### RequiredArgumentMissing errors
6347

64-
> [!div class="nextstepaction"]
65-
> [Known limitations](./known-limitations.md)
48+
| Error message | Suggested action |
49+
|--------------------|-----------------------------|
50+
| `{Argument} shouldn't be blank` | Provide an argument value for interactive input. |
51+
| `Required keys missing for parameter {Parameter}. All possible keys are: {Keys}` | Provide a value for the authentication information parameter, usually in the form `--param key1=val1 key2=val2`. |
52+
| `Required argument is missing, please provide the arguments: {Arguments}` | Provide the required argument. |
53+
54+
### Validation errors
55+
56+
| Error message | Suggested action |
57+
|--------------------|-----------------------------|
58+
| `Only one auth info is needed` | Make sure to provide one and only one authentication information parameter. |
59+
| `Auth info argument should be provided when updating the connection: {ConnectionName}` | Provide the authentication information when you update a secret connection type. The Azure Resource Manager API can't access a user's secret. |
60+
| `Either client type or auth info should be specified to update` | Provide either client type or authentication information when you update a connection. |
61+
| `Usage error: {} [KEY=VALUE ...]` | Check the available keys and provide values for the authentication information parameter, usually in the form `--param key1=val1 key2=val2`. |
62+
| `Unsupported Key {Key} is provided for parameter {Parameter}. All possible keys are: {Keys}` | Check the available keys and provide values for the authentication information parameter, usually in the form `--param key1=val1 key2=val2`. |
63+
| `Provision failed, please create the target resource manually and then create the connection. Error details: {ErrorTrace}` | Retry. If necessary, create the target resource manually and then create the connection. |
64+
65+
## Related content
66+
67+
- [Service Connector concepts](./concept-service-connector-internals.md)
68+
- [Service Connector known limitations](./known-limitations.md)

0 commit comments

Comments
 (0)